# Notion

An MCP server linking your Notion workspace to AI agents: search documents, fetch Markdown, build databases with SQL DDL, and manage comments.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 3841 installs
- Author: notion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/notion
- Updated: 2025-08-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/notion

## What it does

This integration connects your workspace to the model via the remote endpoint `https://notion.run.tools`. The assistant runs semantic queries across internal records and synced external platforms like GitHub, Jira, or Slack. Page content is retrieved as enhanced Markdown through `notion-fetch`. User directories support cursor pagination.

Database administration relies on SQL DDL syntax. Specifically, `notion-create-database` accepts a CREATE TABLE definition to set up schemas, while `notion-update-data-source` modifies existing collections. Inspecting the target schema with fetch beforehand is necessary so property keys match database columns.

Cloning content with `notion-duplicate-page` happens asynchronously, meaning the duplicated record is not populated immediately. The integration also updates database views, moves nodes between parent containers, and exports comment trees formatted in XML.

## Requirements
- Remote server: `https://notion.run.tools`
- Works with: Notion

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http notion https://notion.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add notion --url https://notion.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "notion": {
            "url": "https://notion.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "notion": {
            "type": "http",
            "url": "https://notion.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http notion https://notion.run.tools
```

## When to use it
- find workspace documents with semantic search
- define and build databases using SQL DDL
- retrieve and update page properties
- leave comments anchored to specific blocks

## Example prompts
- Search Notion for database architecture notes updated last week
- Create a new page with meeting action items under the engineering root
- Duplicate the onboarding checklist and leave a comment on the first heading

## Similar
- [notion-research-documentation](https://affpapa.org/en/nevibecode/skills/notion-research-documentation-2.md) — skill · 390 installs
- [pp-notion](https://affpapa.org/en/nevibecode/skills/pp-notion.md) — skill · 394 installs
- [WireCat notion](https://affpapa.org/en/nevibecode/mcp/wirecat-notion.md) — MCP server · ★ 1 repo stars
- [easy-notion](https://affpapa.org/en/nevibecode/mcp/easy-notion.md) — MCP server · ★ 56 repo stars
- [better-notion-mcp](https://affpapa.org/en/nevibecode/mcp/n24q02m-better-notion-mcp.md) — MCP server · ★ 36 repo stars
- [notion_integration](https://affpapa.org/en/nevibecode/skills/notion-integration.md) — skill · 1 install

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

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