Notion MCP server
com.foreverworks · Updated
Search, read and write your Notion workspaces, with pages as Markdown and typed database queries.
At a glance
Notion is an MCP server in the Databases & Storage category. It runs locally over stdio via `npx -y @foreverworks/mcp-notion`, and needs NOTION_TOKENS_DIR. It scores A (81/100) on the MCP Skills Hub health score as of Oct 27, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install Notion in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install Notion in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add notion -e 'NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR>' -- npx -y @foreverworks/mcp-notionFill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
Verify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes. It discovers them automatically.
How to install Notion in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "notion": { "command": "npx", "args": [ "-y", "@foreverworks/mcp-notion" ], "env": { "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>" } } } }Fill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install Notion in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "notion": { "command": "npx", "args": [ "-y", "@foreverworks/mcp-notion" ], "env": { "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>" } } } }Fill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install Notion in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.notion] command = "npx" args = ["-y", "@foreverworks/mcp-notion"] env = { NOTION_TOKENS_DIR = "<NOTION_TOKENS_DIR>" }Fill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install Notion in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "notion": { "command": "npx", "args": [ "-y", "@foreverworks/mcp-notion" ], "env": { "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>" } } } }Fill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install Notion in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "notion": { "command": "npx", "args": [ "-y", "@foreverworks/mcp-notion" ], "env": { "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>" } } } }Fill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
How to install Notion in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "notion": { "type": "stdio", "command": "npx", "args": [ "-y", "@foreverworks/mcp-notion" ], "env": { "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>" } } } }Fill in your credentials
Replace <NOTION_TOKENS_DIR> with your real value. Keep secrets out of any config file you commit.
Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What does Notion need from you?
Configuration only — Declares config values but no credentials.
NOTION_TOKENS_DIRrequiredEnvironment variableA folder holding one file per workspace, notion-<label>, each with that workspace's integration token or personal access token.
Pass secrets through your shell environment rather than committing them into a config file.
What tools does Notion expose?
This server runs as a local package. We only query remote servers for their tool list — asking this one would mean executing it, so its tools are listed in the documentation below.
What the code can do
Read from the published package source — never executed. Parsed 63 of 63 source files.
This server can read and write files, make network requests and read your environment variables.
How it was published
- Has a provenance attestation tying this artifact to the commit it was built from.
- 1 npm maintainer — a single point of compromise · last published by horatiuvlad.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit 1 day ago — Actively maintained.
- Repository created 5 days ago — Very new project with little track record yet.
- 0 GitHub stars — Very little community usage so far.
- 303 weekly downloads — Regularly installed by other developers.
Client compatibility
Health score
A · 81Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 1 day ago.
- Adoption20%29%
0 stars, 303 weekly downloads.
- Transparency20%75%
3/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✗ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (0.1.0).
Documentation
Full READMEmcps
MCP servers that let an AI assistant do a company's everyday work. Most are for services people use anywhere, such as Google Workspace, Notion, Bitwarden, Porkbun, Expo, the app stores and European banks; a second line is for companies in Romania, to file with ANAF, follow the trade register, invoice through Oblio and read the National Bank's rates.
Each server connects an MCP client, such as Claude Code, Claude Desktop, VS Code or Cursor, to one service. They are built on one toolkit, so every tool says what it can change: read (it changes nothing), write (it changes something in your account) or money (it moves money, makes or unmakes a legal or fiscal document, or commits you in a comparable way, such as a bank consent). Your client asks you before each money call.
foreverworks.github.io/mcps presents the servers by who they are for, each with its documentation.
Under each server's name: how settled it is, then how many tools it has and the most they can do. Stable: in daily use, and its tools keep their shape. Beta: works and is in use, but is new, still growing, or reads web pages its service may change. Experimental: rests on something that can break without notice, or covers only part of the service.
For companies in Romania
The paperwork a company in Romania, and the people who run it, do online: e-invoices and declarations with ANAF, filings at the trade register, invoicing, and the National Bank's exchange rates. Each README ends with the other servers we found for that service, and what this one adds.
| Server | What it does | |---|---| | ANAF e-Factura<sub>Stable20 tools, including money</sub> | Read, check and file a Romanian company's e-invoices and e-Transport declarations with ANAF. | | ANAF SPV<sub>Beta16 tools, including money</sub> | Download what ANAF posts to your SPV inbox, request documents, and validate or file declarations. | | BNR exchange rates<sub>Stable5 tools, read-only</sub> | Look up the National Bank of Romania's rate for any day, and convert amounts to and from RON. | | Oblio<sub>Stable17 tools, including money</sub> | Issue and track a Romanian company's invoices on Oblio, with totals computed as ANAF checks them. | | ONRC trade register<sub>Beta9 tools, read and write</sub> | Follow your filings at Romania's trade register, with their documents, fee notes and invoices. |
For everyone
Servers for services people use anywhere. We built each one because the servers we found did less, or there were none; each README's last section names them and says what this one adds.
| Server | What it does | |---|---| | App Store and Google Play<sub>Beta7 tools, read and write</sub> | Read and answer App Store and Google Play reviews, and see TestFlight feedback and crash logs. | | Bitwarden<sub>Stable12 tools, read and write</sub> | Give your assistant its own Bitwarden vault to create logins, type passwords and read 2FA codes. | | Expo Application Services<sub>Beta23 tools, including money</sub> | Find out why an Expo build, workflow run or store submission failed, and roll out updates. | | Enable Banking<sub>Stable10 tools, including money</sub> | Read, search and export statements and balances from banks across Europe, without moving money. | | Google Workspace<sub>Stable115 tools, read and write</sub> | Search and work in Gmail, Calendar, Drive, Docs, Sheets and Slides across several Google accounts. | | Home Assistant<sub>Beta10 tools, read and write</sub> | Read your Home Assistant's states, areas and history, and run its actions, approving locks first. | | Notion<sub>Stable27 tools, read and write</sub> | Search, read and write your Notion workspaces, with pages as Markdown and typed database queries. | | Porkbun<sub>Beta113 tools, including money</sub> | Register domains and manage DNS, hosting and mail at Porkbun, with every purchase confirmed first. | | Trademark search<sub>Beta6 tools, read-only</sub> | Check whether a name is already a registered or pending trademark in the US or the EU. | | TypeSafe<sub>Beta3 tools, read-only</sub> | Get calibrated yes or no answers, choices and scores from TypeSafe's Jev, for one item or 1000 rows. |
Extras
These work, and we use them, but each is built for one particular setup or on an app's unofficial API, so they are not published to npm, the MCP Registry or as desktop bundles. Run them from a clone, and read the README first: it says what the server depends on and what can break.
| Server | What it does | |---|---| | Bolt Food receipts<sub>Experimental8 tools, read-only</sub> | Read your Bolt Food orders as itemised receipts matched to card charges, through an unofficial API. | | Device broker<sub>Experimental10 tools, read and write</sub> | Share your own Android emulators, iOS simulators and desktops between AI agents, in fair turns. | | Glovo receipts<sub>Experimental8 tools, read-only</sub> | Read your Glovo orders as itemised receipts matched to card charges, through an unofficial API. | | Printer and scanner<sub>Experimental10 tools, read and write</sub> | Print, scan and check paper and toner on a network printer, with greys corrected for that printer. | | Smart home<sub>Experimental7 tools, read and write</sub> | Press the buttons of a TV, heater or fan remote by name through a BroadLink IR blaster. |
Excerpt — the full document is on GitHub.
Alternatives to Notion
- read-only-local-mysql-mcp-serverA · 88MCP server for read-only MySQL database queries in Claude Desktop
- read-only-local-postgres-mcp-serverA · 86MCP server for read-only PostgreSQL database queries in Claude Desktop
- read-only-mysql-mcp-serverD · 0MCP server for read-only MySQL database queries in Claude Desktop
- Keboola MCPA · 83Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...
Maintain Notion? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/com-foreverworks-notion)Catalog data refreshed . Something wrong? Report it.