Notion MCP Server — 让 AI Agent 连接你的 Notion 工作区
安装 Notion MCP 服务器，让 Claude Code、Cursor 和 Windsurf 搜索页面、读取数据库、创建内容、管理 Notion 工作区——直接在 AI 编程环境中操作。
安装 Notion MCP Server
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_your_token\", \"Notion-Version\": \"2022-06-28\"}"
}
}
}
}Notion MCP Server — Official Notion Integration
Official Notion MCP server. Search, read, create, and update Notion pages, databases, and blocks from Claude Code, Cursor, or any MCP client. By Notion. 4.1K+ stars.
Notion MCP — Connect AI Agents to Your Knowledge Base
Official MCP server for Notion workspace access. Search pages, read content, create and update databases, and manage tasks in Notion through Claude Code tool calls.
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.
Airweave — Context Retrieval Layer for AI Agents, 50+ Integrations
Open-source context retrieval layer connecting AI agents to 50+ apps including Notion, Slack, GitHub, and Jira. Unified search API with MCP support.
把知识库直接接入 AI Agent
The Notion MCP server bridges the gap between your team's knowledge base and your AI coding assistant. Before MCP, developers would copy-paste specs from Notion into Claude's chat window. Now the agent can search your entire workspace, read database entries, pull up meeting notes, and reference project specs — all within the conversation.
The official server from Notion wraps the Notion API (pages, databases, blocks, search, users) into MCP tools. You authenticate with an internal integration token scoped to specific pages or databases — the AI never sees anything you haven't explicitly shared. This makes it safe for teams with mixed public/private content: share the engineering wiki, keep HR docs private.
The most impactful pattern is spec-driven development. Write a product spec in Notion, point the AI at it, and ask it to implement. The agent reads the spec, writes the code, and can even update the Notion page with implementation status. For teams using Notion as a project management tool, agents can read task databases, update statuses, and create new pages from code review results. Pair with the GitHub MCP server for a complete spec-to-PR workflow, or add a Slack MCP server so the agent can notify your team when it ships.
Notion is where your team writes its intentions. MCP is how your AI agent reads them.
常见问题
What is the Notion MCP server?+
The Notion MCP server is an official MCP implementation from Notion that exposes the Notion API — pages, databases, blocks, search, and users — as structured tools for AI agents. Once installed in Claude Code, Cursor, or any MCP-compatible client, the agent can search your workspace, read page content, query databases, and create or update pages.
How do I create a Notion integration token?+
Go to notion.so/my-integrations, click 'New integration', name it (e.g. 'AI Agent'), select your workspace, and choose capabilities (read content, read comments, optionally insert content). Copy the 'Internal Integration Secret' (starts with ntn_). Then share specific pages or databases with the integration using Notion's 'Share' menu — the integration only sees pages explicitly shared with it.
Can the Notion MCP server modify my pages?+
Yes, if you grant 'Insert content' capability when creating the integration. The server can create pages, append blocks, update database entries, and add comments. For read-only access, only grant 'Read content' capability. Most teams start read-only and add write access once they trust the workflow.
Is it safe to connect the MCP server to my team's Notion?+
Yes, because Notion's integration model is page-scoped. The integration only sees pages and databases that a human has explicitly shared with it. It cannot browse your entire workspace. Use a dedicated integration (not your personal token), share only the pages the AI needs, and revoke access anytime from Notion's settings.
What can I build with the Notion MCP server?+
Common patterns: (1) Spec-driven development — agent reads product specs from Notion and implements them. (2) Meeting-to-action — agent reads meeting notes and creates GitHub issues for action items. (3) Knowledge Q&A — agent searches your wiki and answers technical questions grounded in your docs. (4) Status sync — agent updates a Notion project tracker based on git activity and CI results.