Advertise
MCP.so
Sign In

Notion MCP Server

@ramidecodes

Repository

Basic information

Category

Memory & Knowledge

License

Apache-2.0

Transports

stdio

Author

ramidecodes

About Notion MCP Server

A Model Context Protocol server wrapping the official Notion SDK

Notion MCP Server config

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

{
  "mcpServers": {
    "mcp-server-notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Notion MCP Server tools

6

Find pages or databases

Query and retrieve database entries

Create, retrieve, and update pages

Manage content blocks (paragraphs, lists, etc.)

List users and get user information

Create and list comments

Overview

What is Notion MCP Server?

A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces. It enables AI assistants to search, read, and write Notion pages, databases, and other content.

How to use Notion MCP Server?

Set up a Notion integration at my-integrations, copy the API key, and share the desired pages/databases with that integration. Then run the server using npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key or configure it in Claude Desktop, Cursor AI, or Claude.ai via the JSON format shown in the README.

Key features of Notion MCP Server

  • Full Notion API support through the official SDK
  • MCP compliant for seamless AI integration
  • Tools for search, databases, pages, blocks, users, comments, and link previews
  • Robust error handling with detailed messages
  • Easy configuration with environment variables

Use cases of Notion MCP Server

  • AI assistants searching and retrieving Notion pages or databases
  • Creating and updating Notion pages programmatically
  • Managing content blocks such as paragraphs, lists, and headings
  • Listing users and getting their information
  • Adding comments or link previews to Notion content

Frequently asked questions

1

What does the server depend on?

It requires Node.js/npx to run and a Notion API key. The server uses the official Notion SDK.

2

How does the server authenticate with Notion?

It uses an integration API key passed via the `--api-key` command-line option or a `NOTION_API_KEY` environment variable.

3

Where does data live?

All data stays inside the connected Notion workspace. The server does not store any data; it only exposes the Notion API via MCP.

4

What are the main limitations?

The integration must be explicitly shared with each page or database it accesses. It only has access to pages/databases that have been shared with it. Also, the integration’s capabilities must be enabled in Notion settings.

5

What transport does the server use?

The server uses standard MCP transport (stdio) as an MCP server invoked via `npx`. No network transport is mentioned.

Comments

More Memory & Knowledge MCP servers

server-noonien - shared memory MCP

sequico

Shared, serverless, conflict-free memory for AI agents: a multi-machine drop-in for the MCP memory knowledge graph.

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.

Memlord

MyrikLD

Memlord is a remote MCP server available at https://app.memlord.com.

priostack

ideaswave

Open-source Python SDK & MCP interface for Priostack Agent Context Network (ACN). Zero-setup, autonomous memory orchestration for AI agents.

Advertise