awkoy/notion-mcp-server
by Various
Notion MCP server for Claude, Cursor, ChatGPT & Claude Desktop. Connect AI agents to Notion via Model Context Protocol — pages, databases, blocks, comments, files.
MCP
awkoy/notion-mcp-server
Added 4 July 2026
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/mcpTools exposed
NOTION_TOKENNOTION_PAGE_IDNOTION_RATE_LIMITNOTION_READ_ONLYNOTION_ALLOWED_OPERATIONSNOTION_BLOCKED_OPERATIONSNOTION_CONFIRM_DESTRUCTIVENOTION_UPLOAD_ROOTNOTION_FILE_URLSNOTION_DAILY_LOG_PAGE_IDdata_sourcesget_file_urlget_imageMCP_TRANSPORTMCP_AUTH_TOKENMCP_ALLOWED_HOSTSMCP_ALLOWED_ORIGINS
Clients listed in this record (not verified here)
Claude Desktop, Claude Code, Cursor, Cline, Continue, VS Code, ChatGPT
Notes
160 stars on GitHub. Last updated 2026-07-03. Licensed MIT.
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
Open-source & AI alternatives
Swap-in tools that solve the same job. Weigh the trade-offs before you commit.
Get the free Developer’s Field Guide
A 27-page field guide to the AI coding workflow with Claude. Claude Code, MCP servers, the prompt patterns that work, and what to delegate. Free.
Enter your work email. We send it straight over, plus a few short notes worth knowing. Unsubscribe any time.
