content Official server available

Notion MCP Server

Notion MCP is Notion's official hosted server. Connect Claude, ChatGPT or Cursor over OAuth to search, write and update your content calendar and campaign docs.

Pricing
freemium
Page updated

The hosted MCP works on every Notion plan. A few tools (unlimited SQL queries, meeting notes, connected-source search) need Business or Notion AI.

View docs
https://mcp.notion.com/mcp
Website

Notion runs its own hosted MCP server at https://mcp.notion.com/mcp. You connect it with OAuth, and Claude can then search, read, create and update anything your account can see in that workspace. That's the one to use. The open-source makenotion/notion-mcp-server package still exists, but Notion's docs say it's no longer actively maintained.

For marketers this is mostly about the content calendar. Ask Claude to pull every row in your editorial database that's still in Draft with a publish date this week, check each brief, and write the missing meta descriptions into the page properties. Or have it turn a messy page of call notes into a campaign brief using your template. If Notion is where your content lives, our Notion tool page covers the app itself.

Some tools depend on your plan. SQL queries through notion-query-data-sources share a usage cap unless you're on Business or Enterprise with Notion AI. Meeting-notes queries need Business plus Notion AI, and searching connected sources like Slack or Google Drive needs Notion AI. notion-search is limited to 30 requests a minute.

The caveat: Claude can edit everything you can edit. Workspace owners can see and revoke MCP connections under Settings → Connections. The hosted server also needs an interactive OAuth login, so fully unattended scripts still have to use the regular Notion API.

Official vs community Notion MCP

Notion MCP

Remote server URL: https://mcp.notion.com/mcp

Notion's hosted server is the default choice: OAuth, nothing to install, and new tools show up there first. The old open-source notion-mcp-server package uses an integration token, which can be handy for headless scripts. Notion no longer actively maintains it, though, so only use it if you truly can't do OAuth.

What you can ask it

  • “Show me every post in the Content Calendar database due this week that's still in Draft, and flag any without a target keyword”
  • “Read yesterday's campaign kickoff notes and turn them into a brief using our Campaign Brief template”
  • “Create a page under Q4 Launches with a 6-week promo timeline as a table”
  • “Go through the Blog Ideas database and write a one-line angle for every row where Angle is empty”

Features

  • Search pages and databases, with filters for creator, date and teamspace
  • Fetch any page, database or saved view by URL or ID
  • Create pages and update properties, content, icon and cover
  • Query databases with SQL or run a saved view
  • Create databases and views, move pages and duplicate them
  • Read and add comments on pages
  • Upload files up to 20 MiB and attach them to pages

How to set up the Notion MCP Server

Works with: Claude, Claude Code, ChatGPT, Cursor, VS Code

1. Claude (claude.ai or Desktop): open Settings → Connectors, add Notion and approve the OAuth screen. 2. Claude Code: run
claude mcp add --transport http notion https://mcp.notion.com/mcp
Then type /mcp inside Claude Code and finish the OAuth flow. Add --scope user to use it across all projects. 3. Cursor: create .cursor/mcp.json (or ~/.cursor/mcp.json for every project):
{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
4. ChatGPT / Codex: add this to ~/.codex/config.toml, then run codex mcp login notion:
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
5. Clients that only support local servers: bridge it with mcp-remote:
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.notion.com/mcp"
      ]
    }
  }
}

Alternatives

makenotion/notion-mcp-server

Notion's older open-source server. Token-based and fine for unattended scripts, but no longer actively maintained.

Zapier MCP

Lets Claude add Notion pages or database items as one step in a bigger multi-app action.

FAQ

Is there an official Notion MCP server?
Yes. Notion hosts it at https://mcp.notion.com/mcp and recommends it over its old open-source package.
How do I connect Notion to Claude?
In claude.ai or Claude Desktop, go to Settings → Connectors and add Notion. In Claude Code, run claude mcp add --transport http notion https://mcp.notion.com/mcp, then /mcp to log in.
Is the @notionhq/notion-mcp-server package deprecated?
Notion's docs say it's no longer actively maintained. It still works with an integration token, but new tools only ship on the hosted server.
Is Notion MCP free?
Yes, it works on every Notion plan. Some tools, like unlimited SQL queries and meeting-notes search, need a Business plan or Notion AI.

Added: 2026-02-23 · Last reviewed: 2026-09-22