@microagents/server-notion NPM

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

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")
Retrieve the Secret Key:
- Copy the "Internal Integration Token" from your integration
- This token will be used for authentication
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