Notion MCP Server

What is Notion MCP Server?

Notion MCP Server is an MCP (Model Context Protocol) server that provides tools for interacting with the Notion API, enabling Claude to read and write to a Notion workspace. It is intended for users who want to manage Notion pages, databases, and blocks programmatically through Claude.

How to use Notion MCP Server?

1. Create a Notion integration and obtain an Internal Integration Token.
2. Invite the integration to the pages or databases you want to access.
3. Add a notion server entry to your claude_desktop_config.json with the command node, the built server file path, and the NOTION_API_TOKEN environment variable.
4. Claude can then call the 11 tools exposed by the server (e.g., notion_append_block_children, notion_create_database, notion_query_database).

Key features of Notion MCP Server

• Append, retrieve, and delete blocks (child blocks, specific blocks).
• Retrieve and update pages and their properties.
• Create, query, and update databases.
• Create new items (rows) in a database.
• Pagination support with start_cursor and configurable page_size.

Use cases of Notion MCP Server

• Automate adding content to Notion pages (append child blocks).
• Manage database records (create, query, update, delete).
• Programmatically update property values on existing pages.
• Retrieve block tree information for auditing or migration.

FAQ from Notion MCP Server

How do I set up the Notion integration?

Visit the Notion Your Integrations page, click “New Integration”, name it, and copy the “Internal Integration Token”.

What permissions does the integration need?

The integration must be invited to the relevant Notion pages or databases. Permission errors occur if the integration lacks access or hasn’t been connected.

How do I configure Claude Desktop to use this server?

Add the following to claude_desktop_config.json: a notion entry with command: "node", args pointing to the built server file, and env containing NOTION_API_TOKEN.

What runtime does this server require?

It runs on Node.js (the configuration specifies node as the command).

Are there any limits on the number of items returned?

Yes, for notion_retrieve_block_children and notion_query_database, the default page size is 100 and the maximum is 100.