# Notion MCP Server

> **Notion MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Notion.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/notion
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Work with pages, databases, blocks and collaborative knowledge stored in Notion. Create, update and organize content while building workflows around structured information and documentation.

---

## Details

- Server ID: `notion`
- Version: 1.0.0
- Tools: 14
- Authentication: OAuth, managed by MewCP
- Calls served: 140
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Notion has to be in the toolset
first. In order:

1. Add Notion to your toolset at https://mewcp.com/mcp/notion
2. Connect your Notion account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (14)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `search_notion` _(read)_ — Search all pages and databases by title or list all pages
- `get_page` _(read)_ — Retrieve a Notion page by ID with properties and metadata
- `fetch_page_content` _(read)_ — Retrieve a Notion page with its full content including all child blocks and properties
- `create_page_under_page` _(write)_ — Create a new page under a parent page
- `create_workspace_page` _(write)_ — Create a new page at a workspace level (without parent page)
- `update_page` _(write)_ — Update an existing Notion page's properties and metadata. Providing `properties`, `icon`, `cover`, or other fields replaces the corresponding current values…
- `append_text_block` _(write)_ — Append a text block to a page
- `get_database` _(read)_ — Retrieve a database object by ID with title, parent, and data sources
- `get_data_source` _(read)_ — Retrieve a data source (database schema/properties) by ID
- `query_data_source` _(read)_ — Query a data source to get pages with optional filtering and sorting
- `create_database` _(write)_ — Create a new database as a child of an existing page
- `list_users` _(read)_ — List all users in the workspace (guests not included)
- `get_user` _(read)_ — Retrieve a specific user by their ID
- `get_self` _(read)_ — Retrieve the bot user associated with your API token, including owner and workspace info

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/notion/connect/claude
- ChatGPT: https://mewcp.com/mcp/notion/connect/chatgpt
- VS Code: https://mewcp.com/mcp/notion/connect/vscode
- Cursor: https://mewcp.com/mcp/notion/connect/cursor
- Codex: https://mewcp.com/mcp/notion/connect/codex
- Claude Code: https://mewcp.com/mcp/notion/connect/claude-code
- OpenCode: https://mewcp.com/mcp/notion/connect/opencode
- OpenClaw: https://mewcp.com/mcp/notion/connect/openclaw
- Antigravity: https://mewcp.com/mcp/notion/connect/antigravity
- Hermes: https://mewcp.com/mcp/notion/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/notion/connect/dsh
- Python: https://mewcp.com/mcp/notion/connect/python
- TypeScript: https://mewcp.com/mcp/notion/connect/typescript