mcpbeat Sign in

Notion MCP Server

local only

Notion runs on your own machine — the client starts it, so there is no endpoint to ping. 384 installs a week from npm. Last commit 31 Oct 2026.

Search, read and write your Notion workspaces, with pages as Markdown and typed database queries.

Installs per day peak 303 · avg 12
a month agotoday
384
Installs / week
npm · @foreverworks/mcp-notion
1
Stars
0 open issues
31 Oct 2026
Last commit
3 releases in 90 days
MIT
License
TypeScript

Nothing serious here today

Today is the operative word: we check Notion every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add notion -e 'NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR>' -- npx -y @foreverworks/mcp-notion
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-notion"
      ],
      "env": {
        "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.notion]
command = "npx"
args = ["-y", "@foreverworks/mcp-notion"]
env = { NOTION_TOKENS_DIR = "<NOTION_TOKENS_DIR>" }
.cursor/mcp.json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-notion"
      ],
      "env": {
        "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "notion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-notion"
      ],
      "env": {
        "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
      }
    }
  }
}

Put your own value in place of <NOTION_TOKENS_DIR> (A folder holding one file per workspace, notion-<label>, each with that workspace's integration token or personal access token). The author’s registry entry marks it as required.

Alternatives to Notion

same job, measured the same way
MCP Notion
by infoinlet-marketplace

Notion for AI agents — search, read pages/blocks, query databases, create pages.

46 installs/wk local only
Notion
by mcparmory

Create, update, and manage pages, databases, and workspace users

227 installs/wk local only
Datanotes
by davidefornelli

The engine of your second brain: Markdown notes as database tables, for you and your agents.

1 238 installs/wk local only
MySQL MCP
by gistrec

MCP server for one MySQL database: schema, read-only queries and guarded writes.

89 installs/wk local only
TypeDB
by typedb

Execute TypeQL queries and manage databases and users on a TypeDB server.

local only
Agent Memory MCP
by xultrax-web

Markdown memory for AI agents. Files you can read, edit, grep, and commit. Not a database.

191 installs/wk local only
dFlow
by dflow

Deploy apps, databases, and services in your dFlow workspace.

answering
Pageworkspace
by cloudcorprecords

Notion pages, databases and blocks via the REST API, as MCP tools.

local only

Notion — questions

Answers built from our own checks of this server.

Why is there no uptime for Notion?
Notion runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @foreverworks/mcp-notion was installed 384 times last week.
How do I connect Notion?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @foreverworks/mcp-notion straight from npm; nothing to host, nothing to sign up for.
How many people use Notion?
The npm package @foreverworks/mcp-notion was installed 384 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Notion open source?
Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.