Notion MCP Server

@kyrelldixon

About Notion MCP Server

My implementation of a Notion MCP Server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notion-mcp-kyrelldixon": {
      "command": "bun",
      "args": [
        "run",
        "src/index.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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?

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.

Comments

Basic information

More Memory & Knowledge MCP servers

Ultimate Google Docs & Drive MCP Server

a-bonus

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

605