Notion MCP Server

What is Notion MCP Server?

Notion MCP Server is a Model Context Protocol (MCP) server that bridges AI assistants with the Notion API, allowing programmatic access to Notion workspaces. It is designed for developers and AI tool users who want to query, create, and update Notion databases, pages, and blocks through a standardized interface.

How to use Notion MCP Server?

Install Bun v1.2.9 or higher, clone the repository, run bun install, and set your Notion API token in a .env file as NOTION_API_KEY. Build and run the server with bun run src/index.ts. To use with Claude Desktop, add the configuration block to claude_desktop_config.json, specifying the bun command and the server’s absolute path.

Key features of Notion MCP Server

• Query Notion databases with filtering and sorting
• Create and update database schemas and properties
• Create, retrieve, and update page properties and content
• Search across Notion pages and databases by title
• Standard MCP protocol for seamless AI assistant integration

Use cases of Notion MCP Server

• An AI assistant helping a project manager query and filter task databases.
• Automating page creation from external data into a Notion workspace.
• Updating page properties in bulk based on AI-generated analysis.
• Searching across a large Notion workspace to find relevant documents.

FAQ from Notion MCP Server

What are the prerequisites for using Notion MCP Server?

You need Bun v1.2.9 or higher, a Notion integration token with appropriate permissions, and the Notion pages/databases must be shared with your integration.

How do I set up a Notion integration?

Visit the Notion Your Integrations page, create a new integration, select required permissions, and copy the Internal Integration Token. Then share each page or database with the integration via the Connections menu.

How do I resolve permission errors?

Ensure your integration has the required permissions, verify it is invited to the relevant pages/databases, and confirm the token is correctly set in the .env file or configuration.

How do I configure Notion MCP Server with Claude Desktop?

Add an entry to claude_desktop_config.json under mcpServers with the command bun, args ["run", "src/index.ts"], the absolute path as cwd, and the NOTION_API_KEY environment variable set to your token.