Notion MCP Server

An MCP server implementation that enables Claude to interact with Notion workspaces through the Notion API.

Installation

npm install @microagents/server-notion
# or
yarn add @microagents/server-notion

Usage

Direct Execution

# Set your API token and run
NOTION_API_TOKEN=secret_your_token_here npx @microagents/server-notion

With Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["@microagents/server-notion"],
      "env": {
        "NOTION_API_TOKEN": "secret_your_token_here"
      }
    }
  }
}

Setup

1. Create a Notion Integration:

   • Visit the Notion Your Integrations page
   • Click "New Integration"
   • Name your integration and select appropriate permissions (e.g., "Read content", "Update content")

2. Retrieve the Secret Key:

   • Copy the "Internal Integration Token" from your integration
   • This token will be used for authentication

3. Add the Integration to Your Workspace:

   • Open the page or database you want the integration to access in Notion
   • Click the navigation button in the top right corner
   • Click "Connect to" button and select your integration

Tools

The server provides 17 tools for interacting with Notion:

Block Operations

• notion_append_block_children: Append child blocks to a parent block
• notion_retrieve_block: Retrieve information about a specific block
• notion_retrieve_block_children: Retrieve the children of a specific block
• notion_delete_block: Delete a specific block

Page Operations

• notion_retrieve_page: Retrieve information about a specific page
• notion_update_page_properties: Update properties of a page

Database Operations

• notion_create_database: Create a new database
• notion_query_database: Query a database
• notion_retrieve_database: Retrieve information about a specific database
• notion_update_database: Update information about a database
• notion_create_database_item: Create a new item in a Notion database

Search and User Operations

• notion_search: Search pages or databases by title
• notion_list_all_users: List all users in the Notion workspace
• notion_retrieve_user: Retrieve a specific user by user_id
• notion_retrieve_bot_user: Retrieve the bot user associated with the current token

Comments

• notion_create_comment: Create a comment in Notion
• notion_retrieve_comments: Retrieve a list of unresolved comments

License

MIT

Credits

Based on the original MCP server by Suekou.