notion-mcp

Complete Notion API integration - MCP server developed and supported by Coretext.

This MCP server was generated using the Template Orchestrator and includes the following integrations:

Available Tools

This MCP server provides 20 tools across 1 integrations:

Notion Tools

• notion_get_me: Get current bot user
• notion_search: Search pages and databases
• notion_get_page: Get page by ID
• notion_get_user: Get user by ID
• notion_get_block: Get block by ID
• notion_list_users: List all users
• notion_create_page: Create a new page. Note: Creating pages directly in workspace root requires special permissions - use database or page parents instead.
• notion_update_page: Update page properties
• notion_delete_block: Delete a block
• notion_get_comments: Get comments for a page or block
• notion_get_database: Get database by ID
• notion_update_block: Update block content
• notion_create_comment: Create a comment on a page or block
• notion_list_databases: ⚠️ DEPRECATED: This endpoint is deprecated by Notion API. Use the search endpoint with database filter instead.
• notion_query_database: Query database pages
• notion_create_database: Create a new database
• notion_update_database: Update database properties
• notion_get_page_property: Get page property by ID
• notion_get_block_children: Get block children
• notion_append_block_children: Append blocks to a parent block

Installation

npm install @coretext-ai-public/notion-mcp-3a30f941-8cc7-4662-af46-61a51082500f

Environment Setup

Create a .env file with the following variables:

NOTION_ACCESS_TOKEN=your_notion_access_token_here

Usage

Running the server

# Development mode
npm run dev

# Production mode
npm run build && npm start

Using with Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": ["@coretext-ai-public/notion-mcp-3a30f941-8cc7-4662-af46-61a51082500f"],
      "env": {
        "NOTION_ACCESS_TOKEN": "your_notion_access_token_here"
      }
    }
  }
}

Instructions for Fetching API Keys/Tokens

• COMING SOON

Advanced Features

Request Cancellation

This MCP server supports request cancellation according to the MCP cancellation specification. Clients can cancel in-progress requests by sending a notifications/cancelled message with the request ID.

When a request is cancelled:

• The server immediately stops processing the request
• Any ongoing API calls are aborted
• Resources are cleaned up
• No response is sent for the cancelled request

Progress Notifications

The server supports progress notifications for long-running operations according to the MCP progress specification.

To receive progress updates:

1. Include a progressToken in your request metadata
2. The server will send notifications/progress messages with:
   • Current progress value
   • Total value (when known)
   • Human-readable status messages

Progress is reported for:

• Multi-step operations
• Batch processing
• Long-running API calls
• File uploads/downloads

Example progress notification:

{
  "method": "notifications/progress",
  "params": {
    "progressToken": "operation-123",
    "progress": 45,
    "total": 100,
    "message": "Processing item 45 of 100..."
  }
}

Generated Information

• Generated at: Wed Oct 22 2025 20:42:31 GMT+0000 (Coordinated Universal Time)
• Orchestrator version: 0.0.2
• Template repository: Coretext-AI-Dev/server-template-v2
• Total endpoints: 20