# Notion MCP — Knowledge Base Server for AI Agents

> MCP server that connects AI agents to Notion workspaces. Search pages, read content, create documents, and manage databases through natural language. 2,000+ stars.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_your_integration_token"
      }
    }
  }
}
```

Get your integration token at [notion.so/my-integrations](https://www.notion.so/my-integrations). Share relevant pages with your integration.

---

## Intro

Notion MCP is a Model Context Protocol server that connects AI agents like Claude Code to your Notion workspace with 2,000+ GitHub stars. Search across pages, read content, create new documents, update databases, and manage your knowledge base — all through natural language commands. Your AI agent gains instant access to your team wiki, project docs, and structured databases. Best for teams using Notion as their knowledge base who want AI to read and write to it. Works with: Claude Code, Cursor, any MCP client. Setup time: under 3 minutes.

---

## Available Tools

### `notion_search`
Search across your workspace:
```
"Search Notion for our API authentication documentation"
"Find all pages about deployment procedures"
```

### `notion_read_page`
Read full page content:
```
"Read the onboarding guide page"
"Get the content of our architecture decision records"
```

### `notion_create_page`
Create new pages:
```
"Create a new page in Engineering Wiki titled 'Redis Caching Strategy'"
"Add a meeting notes page under Team Meetings database"
```

### `notion_update_page`
Update existing content:
```
"Add the new API endpoint documentation to our API Reference page"
"Update the deployment checklist with the new monitoring step"
```

### `notion_query_database`
Query structured databases:
```
"Show all open bugs from the Bug Tracker database"
"List projects with status 'In Progress' from the Roadmap"
```

## Use Cases

### AI-Powered Documentation
```
"Read our current API docs in Notion, then update them based on the code changes I just made"
```

### Meeting Notes to Actions
```
"Create a new page from these meeting notes and extract action items into the Tasks database"
```

### Knowledge Retrieval
```
"Check our Notion wiki — do we have documentation on how to set up the staging environment?"
```

### Key Stats
- 2,000+ GitHub stars
- Full CRUD for Notion pages
- Database query support
- Search across workspaces
- Rich text and block support

### FAQ

**Q: What is Notion MCP?**
A: An MCP server that gives AI agents read/write access to your Notion workspace for searching, reading, creating, and updating pages and databases.

**Q: Is Notion MCP free?**
A: The MCP server is open-source. Notion API is free with your Notion plan.

**Q: What permissions does it need?**
A: A Notion integration token with access to the specific pages you want the agent to use. You control which pages are shared.

---

## Source & Thanks

> Built on [Notion API](https://developers.notion.com/). Licensed under MIT.
>
> [mcp-notion](https://github.com/anthropics/mcp-notion) — ⭐ 2,000+

Thanks for bridging AI agents and team knowledge bases.

---

<!-- ZH -->

## 快速使用

将以下配置添加到 `.mcp.json`:

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-notion"],
      "env": {
        "NOTION_API_KEY": "ntn_你的令牌"
      }
    }
  }
}
```

---

## 简介

Notion MCP 是一个将 AI Agent 连接到 Notion 工作区的 MCP 服务器，GitHub 2,000+ stars。搜索页面、读取内容、创建文档和管理数据库。适合使用 Notion 作为知识库并希望 AI 能读写的团队。

---

## 来源与感谢

> Built on [Notion API](https://developers.notion.com/). Licensed under MIT.
>
> [mcp-notion](https://github.com/anthropics/mcp-notion) — ⭐ 2,000+

---
Source: https://tokrepo.com/en/workflows/75851c68-2e1c-4041-876c-c7f8f5cc87d6
Author: MCP Hub