Notion · foreverworks — Claude Code MCP server: features and setup
Connect an AI agent to Notion to search pages, read their contents, and make workspace changes. Useful when you want to work with notes and databases from a chat.
MIT ★ 5 updated 2026-10-29
claude mcp add notion -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notionWhat Notion does
The server lets an agent find pages, read them as Markdown, and query databases, including counting entries by column value or opening saved views. It can also create pages and database entries, change page content and properties, add comments, and upload files. Those write actions affect the Notion workspace.
You need Node 22.19 or later, a token for each workspace, and a folder containing the token files. An integration can access only pages shared with it, so the agent cannot work with a page it cannot see. File downloads also require NOTION_OUTBOX_DIR; upload size is capped at 20 MiB, or 5 MiB on Notion Free.
Install the package with npx and set NOTION_TOKENS_DIR. The server also supports Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI.
What it helps with
- find a page in a Notion workspace
- count database entries by column value
- add a page or database entry
- edit page text or properties
- download attachments to a chosen folder
Example prompts for the agent
- Find the roadmap page in my work workspace and give me a short summary.
- Count the Tasks database entries for each Status value.
- Add a book to Reading List with status To read and the Books tag.
How to install Notion
Platform CLI
claude mcp add notion -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notionReplace <…> with your own values
Platform CLI
codex mcp add notion --env NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notionReplace <…> with your own values
Config file
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-notion"
],
"env": {
"NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"notion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-notion"
],
"env": {
"NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> notion npx -y @foreverworks/mcp-notionReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Notion
How do I install Notion in Claude Code?
Run claude mcp add notion -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notion. Set the folder containing workspace token files; Node 22.19 or later is required.
What does the Notion MCP server do?
It gives an agent tools to search and read pages, query databases, and edit workspace content. It can create entries, change pages, comment, and upload files.
Which Notion pages can an integration access?
It can access only pages shared with that integration. Share the relevant top-level pages; child pages inherit their access.
Similar MCP servers
All MCP servers for Notes, tasks and projects →Notion by other authors comes first.