Notion
Provides comprehensive tools to interact with the Notion API, including managing pages, databases, blocks, and comments via OAuth2 authentication. It enables users to search content, create workspace entries, and manage metadata through the Dedalus f
What is Notion?
Notion is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides comprehensive tools to interact with the notion api, including managing pages, databases, blocks, and comments via oauth2 authentication. it enables users to search content, create workspace ...
Provides comprehensive tools to interact with the Notion API, including managing pages, databases, blocks, and comments via OAuth2 authentication. It enables users to search content, create workspace entries, and manage metadata through the Dedalus f
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- notion_pages
- notion_blocks
- notion_database
- notion_comments
- notion_users
Use Cases
Maintainer
Works with
Installation
NPM
npx -y notion-mcp-serverManual Installation
npx -y notion-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Notion
notion-mcp-server connects Claude and other MCP clients to your Notion workspace via the Notion API, exposing tools for creating and updating pages and databases, querying database entries, managing blocks, and posting comments. It uses Personal Access Tokens for zero-friction authentication that covers your entire workspace, and supports batch operations with up to 10 parallel API calls in a single request. Knowledge workers and teams use it to automate note creation, update project trackers, and query their Notion databases through natural conversation.
Prerequisites
- A Notion account with at least one workspace
- A Notion Personal Access Token (PAT) starting with `ntn_` — create one at https://www.notion.so/profile/integrations under Personal access tokens
- Node.js 18+ for running the server locally
- Claude Desktop or another MCP-compatible client
Create a Notion Personal Access Token
Go to https://www.notion.so/profile/integrations, click the Personal access tokens tab, then click '+ New personal access token'. Name it (e.g., 'Claude'), select your workspace, and copy the token immediately — it starts with `ntn_` and is shown only once.
Open Claude Desktop config
Open your Claude Desktop configuration file. On macOS it lives at `~/Library/Application Support/Claude/claude_desktop_config.json`; on Windows at `%APPDATA%\Claude\claude_desktop_config.json`.
Add the notion-mcp-server entry
Add the server configuration with your Notion token as an environment variable. Paste the token you copied in step 1 where indicated.
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_paste_your_token_here"
}
}
}
}Restart Claude Desktop
Completely quit Claude Desktop (Cmd+Q on macOS, not just close the window) and reopen it. The Notion tools should now appear in the tools list.
Verify the connection
Start a new chat and type `/` — you should see `notion_execute` and `notion_describe` in the slash-command menu. Try asking Claude to list your recent Notion pages.
Notion Examples
Client configuration
Claude Desktop config with optional environment variables to set a default parent page and restrict allowed operations.
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_your_personal_access_token",
"NOTION_PAGE_ID": "optional-default-parent-page-id",
"NOTION_RATE_LIMIT": "3"
}
}
}
}Prompts to try
These prompts map to the actual tools exposed by notion-mcp-server: notion_execute and notion_describe.
- "Create a page called 'Q3 Plan' with a checklist of five action items."
- "Find every page in my Tasks database where Status is 'In Progress'."
- "Add a comment to my 'Meeting Notes' page summarizing today's discussion."
- "Create a new database called 'Book Reviews' with Title, Rating, and Author columns."
- "List all pages I edited in the last 7 days."
- "Append a bullet list to the 'Ideas' page with these three items: [item1], [item2], [item3]."Troubleshooting Notion
'object_not_found' error when accessing pages
This typically happens with Internal Integration tokens, which require you to explicitly share each page with the integration. Switch to a Personal Access Token (PAT starting with `ntn_`) which automatically covers all pages you can see in your workspace.
'Notion auth failed' or 401 Unauthorized
Verify that NOTION_TOKEN in your config contains your full PAT with no extra whitespace. PATs expire one year after creation — if yours is old, generate a new one at https://www.notion.so/profile/integrations. Also confirm you fully restarted Claude Desktop after editing the config.
Tools not appearing after adding the config
Ensure you used Cmd+Q (macOS) or fully exited Claude Desktop from the system tray (Windows), not just closed the chat window. Also check the config file for JSON syntax errors — a trailing comma or missing bracket will prevent the config from loading.
Frequently Asked Questions about Notion
What is Notion?
Notion is a Model Context Protocol (MCP) server that provides comprehensive tools to interact with the notion api, including managing pages, databases, blocks, and comments via oauth2 authentication. it enables users to search content, create workspace entries, and manage metadata through the dedalus f It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Notion?
Install via npm with the command: npx -y notion-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Notion?
Notion works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Notion free to use?
Yes, Notion is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Notion Alternatives — Similar Business Applications Servers
Looking for alternatives to Notion? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Notion in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Notion?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.