# Notion MCP — Connect AI Agents to Your Knowledge Base

> Official MCP server for Notion workspace access. Search pages, read content, create and update databases, and manage tasks in Notion through Claude Code tool calls.

## Install

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

## Quick Use

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_API_KEY": "ntn_..."
      }
    }
  }
}
```

Now ask your AI agent:
```
"Search my Notion for meeting notes from last week"
"Create a new page in the Engineering wiki with this content"
"Update the status of task #42 to Done"
"List all items in my Reading List database"
```

## What is Notion MCP?

Notion MCP is a Model Context Protocol server that connects AI agents to your Notion workspace. Search pages, read page content, create new pages, update database entries, and manage properties — all through structured MCP tool calls. Your AI agent can use Notion as a knowledge base, task manager, or documentation system.

**Answer-Ready**: Notion MCP connects AI agents to Notion workspaces. Search, read, create, and update pages and databases via MCP tool calls. Use Notion as AI knowledge base or task manager. Official Notion integration. Works with Claude Code and Cursor.

**Best for**: Teams using Notion as knowledge base who want AI agent access. **Works with**: Claude Code, Cursor, Claude Desktop. **Setup time**: Under 5 minutes.

## Core Tools

| Tool | What It Does |
|------|-------------|
| search | Search across all pages and databases |
| get_page | Read page content as markdown |
| create_page | Create a new page with content |
| update_page | Modify page properties |
| query_database | Query a Notion database with filters |
| create_database_item | Add entry to a database |
| update_database_item | Update database entry properties |
| list_databases | List all accessible databases |

## Use Cases

| Use Case | How |
|----------|-----|
| Knowledge Q&A | Search docs → Read pages → Answer questions |
| Task Management | Query task DB → Update status → Create new tasks |
| Meeting Notes | Create page → Add structured notes → Link to project |
| Documentation | Search existing docs → Create new pages → Cross-link |
| Sprint Planning | Query backlog DB → Prioritize → Update assignments |

## Setup

### 1. Create Notion Integration

1. Go to [notion.so/my-integrations](https://www.notion.so/my-integrations)
2. Create new integration
3. Copy the API key (starts with `ntn_`)

### 2. Share Pages with Integration

In Notion, click "..." on any page → "Connect to" → Select your integration. The MCP can only access pages shared with the integration.

### 3. Configure MCP

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

## FAQ

**Q: Can the AI edit any page?**
A: Only pages explicitly shared with the integration. This is Notion's permission model.

**Q: Does it support databases?**
A: Yes, full database support — query with filters, create items, update properties.

**Q: Is this the official Notion MCP?**
A: Yes, published by Notion under `@notionhq/notion-mcp-server`.

## Source & Thanks

> Created by [Notion](https://github.com/notionhq). Official MCP server.
>
> [notionhq/notion-mcp-server](https://github.com/notionhq/notion-mcp-server)

<!-- ZH -->

## 快速使用

```json
{"mcpServers": {"notion": {"command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"]}}}
```

让 AI Agent 访问 Notion 知识库。

## 什么是 Notion MCP？

Notion 官方 MCP 服务器，AI Agent 搜索/读取/创建/更新 Notion 页面和数据库。

**一句话总结**：Notion 官方 MCP，AI Agent 通过工具调用搜索/读取/创建/更新页面和数据库，知识库 + 任务管理 + 文档，官方出品。

## 核心工具

search/get_page/create_page/query_database/update_database_item。

## 配置

1. 创建 Notion Integration 获取 API key
2. 在 Notion 中共享页面给 Integration
3. 配置 MCP

## 常见问题

**Q: 能编辑任何页面？**
A: 只能访问共享给 Integration 的页面。

## 来源与致谢

> [notionhq/notion-mcp-server](https://github.com/notionhq/notion-mcp-server) — Notion 官方

---
Source: https://tokrepo.com/en/workflows/32ffd470-52d3-4616-b088-122358a85cef
Author: MCP Hub