Advertise
MCP.so
Sign In

Notion MCP Server

@ghubnerr

RepositoryHomepage

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

ghubnerr

About Notion MCP Server

A Model Context Protocol (MCP) server for integrating with Notion workspaces (made before the official one 😅)

#nodejs#mcp#notion-api#model-context-protocol#mcp-server

Notion MCP Server config

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

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": [
        "/path/to/notion-mcp-server/build/index.js"
      ],
      "env": {
        "NOTION_API_KEY": "your_notion_api_key_here"
      }
    }
  }
}

Notion MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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?

A Model Context Protocol (MCP) server that provides a standardized interface for AI models to access, query, and modify content in Notion workspaces using a Notion API key.

How to use Notion MCP Server?

Clone the repository, install dependencies with npm install, create a .env file with your NOTION_API_KEY, build with npm run build, and start with npm start. To use with Claude for Desktop, add the server configuration to the claude_desktop_config.json file.

Key features of Notion MCP Server

  • Lists all databases in the workspace via notion://databases
  • Retrieves database schema and content by ID
  • Fetches page content and recent workspace updates
  • Includes pre-configured prompts: upcoming-deadlines, project-status, daily-tasks
  • Supports create, update, delete, and restore operations
  • Optional confirmation prompts for destructive actions

Use cases of Notion MCP Server

  • Ask AI about tasks due today in your Notion workspace
  • Get summaries of project status or upcoming deadlines
  • Create new pages in a specific database via natural language
  • Update task statuses or restore pages from backups
  • Review recent changes made to the workspace

Frequently asked questions

1

What are the runtime requirements?

Node.js v16 or higher and a Notion API key from your Notion integrations page.

2

How do I get a Notion API key?

Create one at [Notion integrations](https://www.notion.so/my-integrations) and connect it to your workspace with appropriate permissions.

3

What optional configuration settings are available?

Settings include `DEBUG`, `REQUIRE_CONFIRMATION_FOR_CREATE/UPDATE/DELETE`, `UPDATE_POLLING_INTERVAL`, `MAX_BLOCK_DEPTH`, `BACKUP_DIR`, `BACKUP_RETENTION_DAYS`, and `MAX_BACKUPS_PER_PAGE`.

4

How can I extend the server's functionality?

Add new resources, tools, or prompts in `index.ts`, or enhance API integration in `notion-api.ts`.

5

Where can I find logs for troubleshooting?

Check Claude for Desktop logs (MCP logs) and the server’s standard output and error streams.

Comments

More Memory & Knowledge MCP servers

Scento Perfume API (MCP server): free fragrance API, no key

Scento

Scento Perfume API is a free fragrance API and perfume notes database for developers and AI agents. Search 1,500+ perfumes and 400+ ingredients, compare scents, find similar perfumes, map scent families and build occasio

M1K3

Round-Tower

Local AI agent for your Mac with a built-in MCP server: 18 tools for your notes and PDFs, a temporal memory graph, an on-device LLM and a neural voice. No account, no telemetry. No data centers required.

7

AOCI-CODE

aoci-spec

Local MCP server and CLI that keeps a Git-versioned, model-written index of a codebase and its database schema, so coding agents start each task with the whole system in view.

1.7K

Neither MCP

stonianua

Project context your AI can query through MCP — with source evidence.

Memory

modelcontextprotocol

Model Context Protocol Servers

88.1K
Advertise