notion-public

This is public facing Notion MCP server integrated directly with Notion APIs. Maintained and made public 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/notion-public-629bbcc8-0100-416e-9e1c-e92ca6fee86c

Environment Setup

Create a .env file with the following variables:

GITHUB_TOKEN=your_github_token_here
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-public": {
      "command": "npx",
      "args": ["@coretext-ai/notion-public-629bbcc8-0100-416e-9e1c-e92ca6fee86c"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here",
        "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: Tue Oct 07 2025 22:36:54 GMT+0000 (Coordinated Universal Time)
• Orchestrator version: 0.0.2
• Template repository: Coretext-AI-Dev/server-template-v2
• Total endpoints: 20