WireCat notion — Claude Code MCP server: features and setup
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.
Apache-2.0 ★ 1 updated 2026-11-16
claude mcp add notion-cli -- npx -y @wirecat/notion-cliWhat WireCat notion 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.
What it helps with
- 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 for the agent
- 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.
How to install WireCat notion
Platform CLI
claude mcp add notion-cli -- npx -y @wirecat/notion-cliPlatform CLI
codex mcp add wirecat-notion -- npx -y @wirecat/notion-cliConfig file
{
"mcpServers": {
"wirecat-notion": {
"command": "npx",
"args": [
"-y",
"@wirecat/notion-cli"
]
}
}
}Config file
{
"servers": {
"wirecat-notion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wirecat/notion-cli"
]
}
}
}Platform CLI
gemini mcp add wirecat-notion npx -y @wirecat/notion-cliStep 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 WireCat notion
How do I install WireCat notion in Claude Code?
Run claude mcp add notion-cli -- npx -y @wirecat/notion-cli.
What does WireCat notion do?
It lets an agent read Notion pages and databases, search a synced local copy, and create, edit, or delete pages.
What does WireCat notion need to work?
It needs a Notion token, either a personal access token or one from an internal connection. Account commands also require a profile; the tool stores its token in the system keyring and reads WCNOTION_TOKEN.