# Notion MCP

> Lets your agent search, read, create and update the pages and databases in your Notion workspace, with your own permissions.

Notion's own hosted MCP server. Once you sign in with Notion, your agent can search your workspace, read pages and databases, and create and update pages, databases and comments, with the same access you have. Notion runs it at mcp.notion.com, so there's nothing to install.

What you can do with it
- Search pages and databases, or look up a workspace member by name or email
- Read pages, databases and saved views, and query a database's rows
- Create pages, including from a database template, and create databases with the fields you need
- Update a page's properties and content, and move or duplicate pages
- Read comments and discussions, add comments and reply to them
- Upload files and attach them to pages
- Check your connected calendars and create or update events
- On Business and Enterprise plans with Notion AI, search connected sources such as Slack, Google Drive and GitHub, and query your meeting notes

How it connects
Notion hosts it at https://mcp.notion.com/mcp, with https://mcp.notion.com/sse as a fallback for agents that don't support Streamable HTTP. Add it as a remote MCP server, then sign in with Notion (OAuth) and choose the workspace. Notion documents it for ChatGPT, Claude and more. On Business and Enterprise plans, a workspace owner can create an MCP token for connections that skip the browser sign-in.

Good to know
- It acts with your full Notion permissions: it reaches everything you can, and nothing more.
- It works on every Notion plan. Connected-source search, meeting notes and unlimited database SQL queries need Business or Enterprise with Notion AI, and some search filters need Business or Enterprise.
- Only workspace members can connect it, not guests.
- Enterprise admins can choose which agents members may connect.
- Every call counts toward Notion's standard API rate limits.
- Notion's older open-source notion-mcp-server is no longer actively maintained; Notion recommends this hosted server instead.

- Type: Plugin
- Made by: Notion
- Category: Productivity
- Formats: Remote MCP
- Version: 1.0.1
- Website: https://developers.notion.com/guides/mcp/overview
- Page: https://pluginboard.ai/plugins/notion-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.notion.com/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.notion.com/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.notion.com/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.notion.com/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.notion.com/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.notion.com/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22notion-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.notion.com%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http notion-mcp https://mcp.notion.com/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=notion-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5ub3Rpb24uY29tL21jcCJ9

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "notion-mcp": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http notion-mcp https://mcp.notion.com/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add notion-mcp --url https://mcp.notion.com/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "notion-mcp": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http notion-mcp https://mcp.notion.com/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.notion.com/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add notion-mcp --url https://mcp.notion.com/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.notion.com/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login notion-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add notion-mcp --url https://mcp.notion.com/mcp
```

If it needs a key: For https://mcp.notion.com/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add notion-mcp --url https://mcp.notion.com/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "notion-mcp": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.notion.com/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).