Notion

This MCP server bridges Claude and other AI assistants to your Notion workspace, enabling the AI to view and search databases, create and update pages, manage blocks, and perform many tasks across your Notion content. It lets you run commands from your AI workflows to interact with Notion data in a controlled, secure way.

How to use

You run the server locally and connect it to your MCP client. Once connected, you can ask the AI to list databases, fetch database entries, create or update pages, manage blocks, or search across your workspace. The actions are exposed as high‑level tools you use from your AI workflow, so you don’t need to interact with Notion’s API directly.

How to install

Prerequisites: Node.js (version 14 or higher) and a Notion account.

1. Prepare your Notion API key by creating a new integration in Notion and copying the internal integration token.

2. Obtain the MCP server code and install dependencies.

3. Connect Notion pages to the integration by granting access to each page or database you want the AI to use.

4. Wire the MCP server into your Claude Desktop setup using the concrete configuration provided below.

Configuration and security

The server is configured to run as a local child process that your MCP client can invoke. The example below shows how Claude Desktop can start the server and pass the Notion API key securely.

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "C:\\path\\to\\notion-mcp-server\\server.js"
      ],
      "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
      }
    }
  }
}

Testing the connection

Start a new conversation with Claude and ask it to perform actions like listing databases or creating a page in a specific database to verify the connection and permissions.

Troubleshooting

If you encounter a connection issue, verify that the server path in your client’s config is correct, the Notion API key is valid, and Node.js is installed. If access to Notion content is denied, ensure the page or database is shared with your integration and that the API key has the necessary permissions. If the server won’t start, confirm dependencies are installed and that the environment is set with a valid API key.

Available tools

list-databases

List all databases accessible by the Notion integration.

query-database

Retrieve entries from a specific database based on filters.

create-page

Create a new page within a database with a given title and properties.

update-page

Modify an existing page’s properties or content.

create-database

Create a new Notion database with a specified schema.

update-database

Modify the structure of an existing database.

get-page

Fetch the details of a specific page.

get-block-children

Retrieve content blocks within a page.

append-block-children

Add content blocks to an existing page.

update-block

Edit the content of a specific block.

get-block

View a specific content block.

search

Search across your workspace for pages, databases, or blocks.