▌BestMCPTools.org
Notion MCP logo

Notion MCP

Connect AI to your Notion workspace

ProductivityOpen SourceAll ModelsModerate
Visit Tool4,649 stars
Own Notion MCP? Boost it to the top.✦ Upgrade to Featured

Maintenance status

Active
Last code update: September 20, 2026License: MITChecked September 28, 2026

How to Install Notion MCP

$npx @notionhq/notion-mcp-server

Requires Claude Desktop, Cursor, Windsurf, or another MCP-compatible client.

Setup by client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "notion-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@notionhq/notion-mcp-server"
      ]
    }
  }
}

Claude Code (terminal)

claude mcp add notion-mcp -- npx @notionhq/notion-mcp-server

Add any API keys or environment variables the server's README lists.

About Notion MCP

Read and write Notion pages, databases and blocks from AI agents. Teams that track work outside Notion can pair it with the Asana MCP setup, and for a company wiki the Confluence MCP setup covers the Atlassian side. If your notes live in an Obsidian vault instead, the Obsidian MCP server page covers its setup and what it can change.

Notion MCP is a Productivity MCP server designed for individual operators, founders, and small teams. It enables letting AI assistants act inside your notes, tasks, and calendar by exposing CRUD operations on your productivity stack as MCP tools. Key capabilities include task, note, and calendar reads, create, update, and complete operations, workspace and project scoping, and structured tool calls that work cleanly inside an LLM context. It integrates with Notion, Linear, Todoist, Google Calendar, Obsidian, Asana, and ClickUp, and is best suited for individual operators, founders, and small teams who need daily planning and triage.

Key Features

  • notion
  • docs
  • knowledge
  • Task, note, and calendar reads
  • Create, update, and complete operations
  • Workspace and project scoping

Pricing

Open Source: from Free

Pros & Cons

Pros

  • Removes most tab-switching from daily admin
  • Keeps work in your existing system of record
  • Composable with other MCP servers

Cons

  • Tightly coupled to the host platform's API
  • Bulk operations need careful scoping
  • Cross-app coordination still requires orchestration

Best For

  • Daily planning and triage
  • Capturing tasks from chat
  • Calendar coordination
  • Personal knowledge management

Our Take on Notion MCP

Notion's API can be slow, but this MCP handles pagination cleanly.

Alternatives to Notion MCP

Slack MCPCommunication

Connect AI to your Slack workspace

View Slack MCP →

Frequently Asked Questions

Tags

#Productivity#notion#docs#knowledge