MCP.so
Sign In

Notion MCP Server

@kyrelldixon

Repository

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?

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.

Comments

Basic information

Category

Memory & Knowledge

Transports

stdio

Author

kyrelldixon

More Memory & Knowledge MCP servers

ctxfile

ctxfile

Local-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.

2

MCP Apple Notes

RafalWilinski

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

401

Basic Memory

basicmachines-co

AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN

3.4K

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

1

Notion MCP Server

suekou

A Model Context Protocol server for connecting Notion to MCP-compatible clients

910