Connect to Notion
Use BlackTwist tools inside Notion AI Custom Agents.Notion AI supports custom MCP connections, allowing you to use BlackTwist tools directly within your Custom Agents. BlackTwist supports both OAuth (with dynamic client registration) and API key authentication.Prerequisites
A workspace admin must first enable custom MCP servers. Go to Settings → Notion AI → AI connectors → Enable Custom MCP servers.Setup Steps
- Open your Custom Agent's Settings
- Go to Tools & Access
- Click Add connection → Custom MCP server
- Enter the server URL:
https://blacktwist.app/api/mcp - Give the connection a name (e.g. "BlackTwist")
- For authentication, choose one of the following:
- OAuth — BlackTwist supports dynamic client registration. Notion will redirect you to sign in with your BlackTwist account. Once authorized, tokens refresh automatically.
- Header-based auth — Generate an API key in Settings > MCP, then add a header with name
Authorization and value Bearer YOUR_API_KEY
- Click Save
Once connected, the BlackTwist tools will be available to your Custom Agent — you can schedule posts, check analytics, manage drafts, and more directly from Notion.For more details, see the official Notion MCP guide.