# Notion

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: foreverworks
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/foreverworks/mcps/tree/HEAD/servers/notion
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/foreverworks-notion

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `NOTION_TOKENS_DIR` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Notion

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add notion -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notion
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add notion --env NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notion
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "notion": {
            "command": "npx",
            "args": [
                "-y",
                "@foreverworks/mcp-notion"
            ],
            "env": {
                "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "notion": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@foreverworks/mcp-notion"
            ],
            "env": {
                "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> notion npx -y @foreverworks/mcp-notion
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [notion-automation](https://affpapa.org/en/nevibecode/skills/notion-automation.md) — skill · 5000 installs
- [notion-mcp](https://affpapa.org/en/nevibecode/skills/notion-mcp.md) — skill · 878 installs
- [notion-knowledge-capture](https://affpapa.org/en/nevibecode/skills/notion-knowledge-capture-2.md) — skill · 612 installs
- [pp-notion](https://affpapa.org/en/nevibecode/skills/pp-notion.md) — skill · 394 installs
- [notion-research-documentation](https://affpapa.org/en/nevibecode/skills/notion-research-documentation-2.md) — skill · 390 installs
- [notion-sdk](https://affpapa.org/en/nevibecode/skills/notion-sdk.md) — skill · 133 installs

## Other versions with the same name
- [Notion · ](https://affpapa.org/en/nevibecode/mcp/notion.md) — 3841 installs
- [Notion · makenotion](https://affpapa.org/en/nevibecode/mcp/makenotion-notion.md)
- [Notion · ](https://affpapa.org/en/nevibecode/mcp/docker-notion.md)

From the same set: [foreverworks/mcps](https://affpapa.org/en/nevibecode/by/foreverworks/mcps.md) — 15 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
