suekou/mcp-notion-server

Overview

A community-built MCP server that connects your AI assistant to Notion, letting it read and update pages, databases, and records so questions about your workspace can be answered in conversation instead of clicking through Notion. It covers a broad set of actions, from searching content to creating and updating items in a database. A solid option if you want more tool coverage than the official server offers and are comfortable running your own server.

Best for

Best for
Teams on Notion who want broader tool coverage and are comfortable self-hosting

Use cases

• Search Notion databases and pull specific records into a conversation
• Create a new page or update an existing item's details
• Use Notion as a knowledge base an assistant can search and cite
• Batch-update several records in a database at once

How to use

Tools exposed

• notion_find
• notion_read_page
• notion_inspect_data_source
• notion_query_data_source_by_values
• notion_create_data_source_item_from_values
• notion_append_markdown
• notion_append_content
• notion_update_content
• notion_update_content_batch

Tested with

Claude Desktop, Cursor

Example client config

{\n  "mcpServers": {\n    "notion": {\n      "command": "npx",\n      "args": ["-y", "@suekou/mcp-notion-server"],\n      "env": {\n        "NOTION_API_TOKEN": "your-integration-token"\n      }\n    }\n  }\n}

Notes

This project implements a Model Context Protocol server for Notion. It allows MCP-compatible clients to read and write Notion pages, databases, and blocks. The server acts as a bridge, translating MCP requests into Notion API calls.

895 stars on GitHub. Last updated 2026-05-22. Licensed MIT.

Use cases

• Query Notion databases and retrieve records through MCP clients.
• Create new pages and update existing page properties via natural language prompts.
• Integrate Notion as a knowledge base for AI assistants using the MCP protocol.

Pros

• Open source with a strong community following (895 stars).
• Written in TypeScript, making it familiar and extensible for JavaScript/TypeScript developers.
• Provides a standardized MCP interface for Notion, reducing custom integration effort.

Cons

• Requires self-hosting and managing the server process.
• Dependent on Notion API rate limits and availability.
• Limited to the capabilities exposed by the current MCP specification.

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