home / mcp / notion mcp server

Notion MCP Server

Provides a Notion-integrated MCP server that saves and queries Notion data from Claude Desktop and tracks learning progress.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "itsiiromiuy-notion-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/notion-mcp-server/dist/index.js"
      ],
      "env": {
        "NOTION_API_TOKEN": "ntn_your_token",
        "NOTION_DATABASE_ID": "your_database_id",
        "NOTION_PARENT_PAGE_ID": "your_page_id"
      }
    }
  }
}

You can run a dedicated MCP server that connects Claude Desktop with Notion, enabling automatic saving of conversations and Q&A, querying Notion databases from Claude, and tracking learning progress with structured data in Notion.

How to use

You use the MCP server by configuring Claude Desktop to connect to the local MCP server, then invoking the Notion-related tools from Claude to save entries, search your Notion data, and update mastery levels. The server handles requests from Claude Desktop and communicates with the Notion API to store and retrieve information in your Notion workspace.

How to install

Follow these concrete steps to set up the MCP server and integrate it with Claude Desktop.

# 1. Clone the repository
git clone https://github.com/itsiiromiuy/notion-mcp-server.git
cd notion-mcp-server

# 2. Install dependencies
npm install

# 3. Create a .env file with required variables
NOTION_API_TOKEN=your_notion_integration_token
NOTION_DATABASE_ID=your_notion_database_id
NOTION_PARENT_PAGE_ID=your_notion_page_id (only needed for database setup)

Configuration and startup

Configure your Notion integration, environment, and Claude Desktop to start using the MCP server. You’ll provide API credentials, designate a Notion page for the database, and point Claude Desktop to the MCP entry point.

# .env example content
NOTION_API_TOKEN=your_notion_integration_token
NOTION_DATABASE_ID=your_notion_database_id
NOTION_PARENT_PAGE_ID=your_notion_page_id
```

# Claude Desktop configuration (example)
```
{
  "mcpServers": {
    "notion-mcp": {
      "command": "node",
      "args": [
        "/path/to/notion-mcp-server/dist/index.js"
      ],
      "env": {
        "NOTION_API_TOKEN": "your_token",
        "NOTION_PARENT_PAGE_ID": "your_page_id",
        "NOTION_DATABASE_ID": "your_database_id"
      }
    }
  }
}
```

# Start the MCP server (runtime)
npm run build
node dist/index.js

Security and best practices

Do not commit sensitive credentials. Store your tokens securely and keep your .env file untracked. Restrict access to Claude Desktop and the machine running the MCP server.

Available tools

notion_ai_save_entry

Save Q&A pairs and conversations to Notion automatically from Claude Desktop.

notion_query_database

Query and search your Notion database from Claude to retrieve relevant information.

notion_update_mastery

Track learning progress with mastery levels and update status from Claude.