Skip to main content
Notion MCP connects Notion’s hosted MCP (Model Context Protocol) server to Cargo so AI agents can search and update your Notion workspace. Authorization is browser-based OAuth — no Notion integration token or API key is required.

​
How to set up Notion MCP

​
Authentication

Notion MCP uses OAuth authorization:
  1. Create a Notion MCP connector in Cargo
  2. Click Authorize Notion MCP
  3. Sign in to Notion in the popup and choose which workspace to grant access to
  4. Cargo stores the resulting token and refreshes it automatically
Code slugs — integration slug: notionMcp. This integration exposes no fixed actions: its tools are discovered from Notion’s MCP server at runtime and made available to agents.

​
Notion MCP tools

The connector does not define static actions. When attached to an agent as an MCP server, the agent lists the tools Notion’s server advertises at runtime — searching pages, reading and updating content — and can call any of them. See MCP servers for how agents use MCP tools. Related MCP integrations: HubSpot MCP and Salesforce MCP.

​
Best practices

  • Grant access only to the Notion workspace (and pages) your agents actually need
  • Authorize with a Notion user whose permissions match what you want agents to be able to do
  • Re-authorize the connector if access is revoked from Notion’s connected-apps settings