# WireCat notion

WireCat notion — an MCP server for Claude Code and Codex gives agents access to Notion pages, local search, and page edits. It connects through a Notion profile.

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

## What it does

WireCat notion exposes Notion pages and databases through its CLI and MCP server. `notion personal documents get` prints a page as Markdown; `notion personal sync` copies pages, nested pages, databases, and rows into WireCat's shared store. The local copy supports offline searches using Lucene syntax.

The CLI can create a page from a Markdown file, replace page text, and move a page to Notion's trash after confirmation. An update that would remove a child page or database requires `--allow-deleting-content`; `--dry-run` previews a write without sending it. Account commands need a profile and a Notion token. The token goes in the system keyring, and this tool reads `WCNOTION_TOKEN`, not `NOTION_TOKEN`.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Notion

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add notion-cli -- npx -y @wirecat/notion-cli
```

### Codex

**Platform CLI**
```bash
codex mcp add wirecat-notion -- npx -y @wirecat/notion-cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "wirecat-notion": {
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/notion-cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "wirecat-notion": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@wirecat/notion-cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add wirecat-notion npx -y @wirecat/notion-cli
```

## When to use it
- Read a Notion page as Markdown
- Copy pages and databases into local storage
- Search a synced copy while offline
- Create or replace a page from a Markdown file

## Example prompts
- Search my Notion copy for pages containing “release plan”.
- Read the Notion page at this link and return its Markdown.
- Create a Notion page under the given parent using `notes.md`.

## Similar
- [pp-notion](https://affpapa.org/en/nevibecode/skills/pp-notion.md) — skill · 394 installs
- [Notion](https://affpapa.org/en/nevibecode/mcp/notion.md) — MCP server · 3841 installs
- [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
- [c-notion](https://affpapa.org/en/nevibecode/skills/c-notion.md) — skill · ★ 179 repo stars
- [notion-automation](https://affpapa.org/en/nevibecode/skills/notion-automation.md) — skill · 5000 installs

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