Notion MCP

How to Install and Use Notion MCP

Notion MCP is a remote server that helps you connect AI tools with your Notion workspace easily. It uses OAuth for simple setup and is designed to work well with AI agents while saving tokens. Here’s how to install and use it step-by-step.

Step 1: Set Up Integration in Notion

First, you need to create an integration in Notion. This integration allows Notion MCP to access your workspace data safely.

• Go to https://www.notion.so/profile/integrations.
• Create a new internal integration or pick an existing one.
• For better security, you can limit the integration’s access. For example, give it only "Read content" permission to make it read-only.

This step connects your Notion workspace to the MCP server securely.

Step 2: Connect Your Content to the Integration

Next, you must give the integration access to the pages or databases you want to use with Notion MCP.

• Open your integration settings and go to the Access tab.
• Edit access and select the pages or databases you want to connect.
• Alternatively, open a page in Notion, click the three dots in the top right, and choose "Connect to integration."

This ensures the MCP server can read or modify the right content in your workspace.

Step 3: Add MCP Configuration to Your Client

Now, you need to tell your AI client how to use the Notion MCP server. You do this by adding a config file with your integration token.

Using npm (recommended)

Add this to your .cursor/mcp.json or claude_desktop_config.json file:

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Replace "ntn_****" with your actual integration secret from Notion.

Using Docker

You can also run the MCP server with Docker. Here’s an example using the official Docker image:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "NOTION_TOKEN",
        "mcp/notion"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

Again, replace "ntn_****" with your integration token.

Step 4: Choose Transport Mode

Notion MCP supports two ways to communicate: STDIO (default) and Streamable HTTP.

• To run with the default STDIO transport, just run:

  npx @notionhq/notion-mcp-server
  

• To use HTTP transport on port 3000, run:

  npx @notionhq/notion-mcp-server --transport http
  

You can add a custom port or authentication token if needed.

Step 5: Try Example Commands

Once set up, you can send instructions to Notion MCP. For example:

• To add a comment:

  Comment "Hello MCP" on page "Getting started"
  

• To add a new page:

  Add a page titled "Notion MCP" to page "Development"
  

• To get page content by ID:

  Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2
  

These commands show how MCP plans and executes API calls to Notion.

---

By following these steps, you can quickly install and start using Notion MCP to connect AI tools with your Notion workspace in a secure and easy way.