Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add notion -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notion
Open on GitHub

What 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-notion

Replace <…> 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.

Notion notion An MCP server linking your Notion workspace to AI agents: search documents, fetch Markdown, build databases with SQL DDL, and manage comments. CX Codex +1 3,841installs Notion makenotion Self-hosted MCP server for the Notion API: 22 tools for search, pages and data sources. Notion now points to its hosted replacement. CX Codex +1 Notion docker Connects Notion workspaces to coding agents to manage projects, organize knowledge, and write technical documentation. CX Codex +1 notion-automation claude-office-skills notion-automation automates Notion databases and page templates with cross-platform triggers. Useful for handling leads, task digests, and calendar events. CX Codex +1 5,000installs notion-mcp Dokhacgiakhoa Connects Notion to your AI coding agent. The skill lets your agent search workspace pages, inspect databases, and append findings directly from the CLI. CX Codex +1 878installs notion-knowledge-capture makenotion notion-knowledge-capture — a skill for Claude Code turns session context and raw notes into Notion guides, ADR entries, FAQs, or meeting notes. Operates directly on the agreed conversation details. CX Codex +1 612installs pp-notion Nikica Jokic pp-notion drives Notion from the terminal through CLI commands, syncs pages to local SQLite, and tracks recent edits. Useful for workspace audits and agent automation. CX Codex +1 394installs notion-research-documentation makenotion notion-research-documentation — a skill for Claude Code and Codex that explores Notion workspaces and external sources. Generates cited briefs, comparisons, and research summaries saved directly to your workspace. CX Codex +1 390installs notion-sdk terrylica notion-sdk — a skill for managing Notion via the official Python SDK. Creates pages and databases, queries information, adds content blocks — all programmatically. CX Codex +1 133installs

From the same set15

The whole set →
ECB exchange rates The ECB exchange rates MCP server for Claude Code fetches the European Central Bank’s euro reference rates and converts amounts between currencies. Ask for a rate on a specific date or for a period. CX Codex +1 ★ 5repo stars Expo Application Services Expo Application Services is an MCP server for Claude Code that diagnoses failed builds, workflow runs, and store submissions. It can also inspect credentials and manage updates. CX Codex +1 ★ 5repo stars Bitwarden This MCP server for Claude Code connects an agent to a separate Bitwarden vault. It handles login records, 2FA codes, and passkeys. CX Codex +1 ★ 5repo stars App Store and Google Play This MCP server for Claude Code reads App Store and Google Play reviews, plus TestFlight feedback and crash logs. It can publish replies under the developer’s name. CX Codex +1 ★ 5repo stars ANAF SPV The ANAF SPV MCP server for Claude Code retrieves documents from an SPV inbox and sends requests to ANAF. It can also validate declarations and file D212. CX Codex +1 ★ 5repo stars Oblio Issues and tracks Romanian fiscal invoices through the Oblio API. Computes totals according to ANAF rules directly in AI coding assistants. CX Codex +1 ★ 5repo stars Enable Banking Enable Banking — an MCP server to inspect balances and export transactions across European banks via PSD2 without transferring funds. CX Codex +1 ★ 5repo stars BNR exchange rates BNR exchange rates is an MCP server for Claude Code that queries Romania’s central bank rates and converts amounts to or from RON. It checks fixings by date and annual D212 averages. CX Codex +1 ★ 5repo stars

Project sponsors

Companies that keep this analytics open