MCP.so
Sign In

Notion MCP Server

@Akira-Papa

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

Akira-Papa

About Notion MCP Server

Notion MCPでブロックやトグルなどしようできるようにしたサーバー

Notion MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "your-built-file-path"
      ],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Notion MCP Server tools

9

Information about the appended blocks.

Detailed information about the block.

List of child blocks.

Confirmation of the deletion.

Detailed information about the page.

Information about the updated page.

Information about the created database.

List of results from the query.

Detailed information about the database.

Overview

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.

Frequently asked questions

1

How do I set up the Notion integration?

Visit the [Notion Your Integrations page](https://www.notion.so/profile/integrations), click “New Integration”, name it, and copy the “Internal Integration Token”.

2

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.

3

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`.

4

What runtime does this server require?

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

5

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.

Comments

More Memory & Knowledge MCP servers