awkoy/notion-mcp-server

Overview

A TypeScript server that exposes Notion's pages, databases, blocks, comments, and files through the Model Context Protocol. It lets Claude, Cursor, ChatGPT and Claude Desktop read and write to Notion workspaces via a standardized interface.

Best for

Best for
Developers who want to connect AI coding assistants or agents to their Notion workspace for automated document management and data retrieval.

Use cases

• Create and update Notion pages from AI agent conversations
• Query Notion databases and retrieve structured data for analysis
• Manage comments and blocks within Notion documents programmatically

How to use

Install

npx @modelcontextprotocol/inspector --transport http --server-url http://127.0.0.1:3000/mcp

Tools exposed

• NOTION_TOKEN
• NOTION_PAGE_ID
• NOTION_RATE_LIMIT
• NOTION_READ_ONLY
• NOTION_ALLOWED_OPERATIONS
• NOTION_BLOCKED_OPERATIONS
• NOTION_DAILY_LOG_PAGE_ID
• data_sources
• MCP_TRANSPORT
• MCP_AUTH_TOKEN
• MCP_ALLOWED_HOSTS
• MCP_ALLOWED_ORIGINS

Tested with

Claude Desktop, Claude Code, Cursor, Cline, Continue, VS Code, ChatGPT

Notes

A TypeScript server that exposes Notion’s pages, databases, blocks, comments, and files through the Model Context Protocol. It lets Claude, Cursor, ChatGPT and Claude Desktop read and write to Notion workspaces via a standardized interface.

160 stars on GitHub. Last updated 2026-07-03. Licensed MIT.

Use cases

• Create and update Notion pages from AI agent conversations
• Query Notion databases and retrieve structured data for analysis
• Manage comments and blocks within Notion documents programmatically

Pros

• Works with multiple popular AI assistants and IDEs out of the box
• Open source and built on the established Model Context Protocol
• Covers core Notion objects (pages, databases, blocks, comments, files)

Cons

• Requires a Notion integration token with proper permissions
• Limited to capabilities exposed by the Notion API (no offline or real-time sync)
• Dependent on the client’s MCP implementation for stability and features

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.