MCP ConfigsApr 6, 2026·2 min read

Notion MCP — Knowledge Base Server for AI Agents

MCP server that connects AI agents to Notion workspaces. Search pages, read content, create documents, and manage databases through natural language. 2,000+ stars.

MC
MCP Hub · Community
Quick Use

Use it first, then decide how deep to go

This block should tell both the user and the agent what to copy, install, and apply first.

Add to your .mcp.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token"
      }
    }
  }
}

Get your integration token at notion.so/my-integrations. Share relevant pages with your integration.


Intro

Notion MCP is a Model Context Protocol server that connects AI agents like Claude Code to your Notion workspace with 2,000+ GitHub stars. Search across pages, read content, create new documents, update databases, and manage your knowledge base — all through natural language commands. Your AI agent gains instant access to your team wiki, project docs, and structured databases. Best for teams using Notion as their knowledge base who want AI to read and write to it. Works with: Claude Code, Cursor, any MCP client. Setup time: under 3 minutes.


Available Tools

notion_search

Search across your workspace:

"Search Notion for our API authentication documentation"
"Find all pages about deployment procedures"

notion_read_page

Read full page content:

"Read the onboarding guide page"
"Get the content of our architecture decision records"

notion_create_page

Create new pages:

"Create a new page in Engineering Wiki titled 'Redis Caching Strategy'"
"Add a meeting notes page under Team Meetings database"

notion_update_page

Update existing content:

"Add the new API endpoint documentation to our API Reference page"
"Update the deployment checklist with the new monitoring step"

notion_query_database

Query structured databases:

"Show all open bugs from the Bug Tracker database"
"List projects with status 'In Progress' from the Roadmap"

Use Cases

AI-Powered Documentation

"Read our current API docs in Notion, then update them based on the code changes I just made"

Meeting Notes to Actions

"Create a new page from these meeting notes and extract action items into the Tasks database"

Knowledge Retrieval

"Check our Notion wiki — do we have documentation on how to set up the staging environment?"

Key Stats

  • 2,000+ GitHub stars
  • Full CRUD for Notion pages
  • Database query support
  • Search across workspaces
  • Rich text and block support

FAQ

Q: What is Notion MCP? A: An MCP server that gives AI agents read/write access to your Notion workspace for searching, reading, creating, and updating pages and databases.

Q: Is Notion MCP free? A: The MCP server is open-source. Notion API is free with your Notion plan.

Q: What permissions does it need? A: A Notion integration token with access to the specific pages you want the agent to use. You control which pages are shared.


🙏

Source & Thanks

Built on Notion API. Licensed under MIT.

mcp-notion — ⭐ 2,000+

Thanks for bridging AI agents and team knowledge bases.

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets