Makenotion Notion MCP Server

🚀 Notion MCP Server

This project implements an MCP Server for the Notion API.

🚀 Quick Start

This project implements an MCP Server for the Notion API.

📦 Installation

1. Set up an integration in Notion:

Visit https://www.notion.so/profile/integrations to create a new internal integration or select an existing one.

Although we limit the scope of the exposed Notion API (e.g., you can't delete databases via MCP), there's a non - zero risk in exposing data to LLMs. Security - conscious users may want to further configure the integration's capabilities.

For example, you can create a read - only integration token with only "Read content" access (from the "Configuration" tab):

2. Add MCP configuration to the client:

Using npm:

Add the following to your .cursor/mcp.json or claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Using Docker:

You can also run the MCP server using Docker. First, build the Docker image:

docker-compose build

Then add the following to your .cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server-notion-mcp-server"
      ]
    }
  }
}

Don't forget to replace ntn_**** with your integration secret token. Find it from the integration configuration tab:

3. Connect to a database

Create a free account on Notion and create some databases.

💻 Usage Examples

Basic Usage

Command - line example:

echo "{
  \"messages\": [
    {
      \"role\": \"user\",
      \"content\": \"Tell me something about artificial intelligence.\"
    }
  ],
  \"model\": \"gpt-3.5-turbo\",
  \"temperature\": 0.7
}" | curl -X POST http://localhost:1234/v1/chat/completions

Python example:

import requests

url = "http://localhost:1234/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
}
data = {
    "messages": [
        {"role": "user", "content": "Tell me something about artificial intelligence."}
    ],
    "model": "gpt-3.5-turbo",
    "temperature": 0.7
}

response = requests.post(url, json=data)
print(response.json())

🔧 Technical Details

Development

Install dependencies:

npm install

Run tests:

npm test

Build the project:

npm run build

Run the server:

npm start

⚠️ Important Note

• Ensure that your Notion integration token has appropriate permissions.
• Use a smaller temperature value during testing for more deterministic results.