Best for
- Users who need AI agents to access Notion workspaces
- MCP workflows involving common page editing and data source operations
- Notion API workflows that benefit from compact responses and simplified tools
N
Notion MCP Server
Community
An AI-friendly MCP server for Notion workflows
GitHub source repository ↗
54FMRS · D
An MIT-licensed Notion MCP server covering common workflows from search and reading through data source operations and page editing. The source shows stdio-based configuration and suitability for AI workflows with explicitly configured Notion integration access. The repository is not maintained by Notion, so it is not an official server.
An MCP server that connects Notion with MCP-compatible clients and supports finding, reading, querying, and updating Notion workspaces. It targets the Notion API 2026-03-11, uses the current data source model, and provides compact responses, structured tool results, prompts, resources, and optional interactive MCP Apps.
Tools
notion_find
Find pages or data sources.
notion_read_page
Read page content with stable block IDs.
notion_inspect_data_source
Inspect a data source schema.
notion_query_data_source_by_values
Query a data source using simple values.
notion_create_data_source_item_from_values
Create a data source item from simple values.
notion_append_markdown
Safely append Markdown to a page.
notion_append_content
Append common content blocks to a page.
notion_update_content
Update page content.
notion_update_content_batch
Update page content in batches.
Setup
Add install_config to the MCP host configuration, replace NOTION_API_TOKEN with the Notion internal integration token, and restart the MCP host. First create an internal integration in Notion, configure the required capabilities, and grant access to target pages or databases in Content access. Access can also be granted from a target page or database through its Connections menu.
claude_desktop_config.json
{"mcpServers":{"notion":{"command":"npx","args":["-y","@suekou/mcp-notion-server"],"env":{"NOTION_API_TOKEN":"your-integration-token"}}}}
Fit and risk
Not for
- Workflows that do not use Notion
- Users who need to access content that has not been shared with the integration
- Cases requiring advanced API shapes not covered by the simplified tools when raw JSON tools are unsuitable
Required permissions
- Read content is required for search, page reads, data source retrieval, and queries
- Insert content is required for creating pages or items and appending blocks
- Update content is required for updating pages, blocks, and data source schemas
- Read comments and Insert comments are required only for comment tools
- User information is required only for user lookup tools
- The integration can access only pages and databases shared with it
Risks and side effects
- With insert or update capabilities enabled, an agent can create or modify authorized Notion content
- Overly broad access grants may expose unnecessary pages or databases to the server
- Relevant operations may fail when required Notion capabilities or content access are missing
- The server targets Notion API 2026-03-11 and the current data source model
Troubleshooting
- Check that NOTION_API_TOKEN contains the correct internal integration token
- Restart the MCP host after saving configuration changes
- Verify that the required read, insert, or update capabilities are enabled
- Verify that the target page or database is granted in Content access or connected through Connections
- For full functionality, check that read, insert, and update content capabilities are enabled
Use cases
Finding and reading Notion pages
Inspecting, querying, and creating data source items
Appending paragraphs, headings, lists, todos, quotes, callouts, code blocks, and dividers
Updating page content and performing batch edits
Using the optional Data Source Explorer and Page Workbench MCP Apps
Supported clients
Claude DesktopFull support
CursorFull support