# Notion MCP

[![Verified by MCPForge](https://www.mcpforge.tech/api/badge/verified/notion-mcp-mqks51f7-mqks51f7)](https://www.mcpforge.tech/verified/notion-mcp-mqks51f7)
[![smithery badge](https://smithery.ai/badge/kamolc4/notion-mcp)](https://smithery.ai/servers/kamolc4/notion-mcp)

MCP server for the [Notion API](https://developers.notion.com), generated with [MCPForge](https://mcpforge.tech).

This MCP server exposes core Notion operations as tools that Claude and other MCP-compatible AI agents can call directly — from querying databases and searching pages to creating and updating content.

---

## Live Endpoint

```
https://www.mcpforge.tech/api/servers/notion-mcp-nytr8
```

No setup required — connect Claude Desktop or any MCP client to this endpoint and start using it immediately.

---

## Usage

### Claude Desktop

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "notion-mcp": {
      "url": "https://www.mcpforge.tech/api/servers/notion-mcp-nytr8",
      "transport": "http"
    }
  }
}
```

Config file location:
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

### Cursor

Add to your Cursor MCP settings:

```json
{
  "mcpServers": {
    "notion-mcp": {
      "url": "https://www.mcpforge.tech/api/servers/notion-mcp-nytr8",
      "transport": "http"
    }
  }
}
```

---

## Available Tools

10 tools for reading and writing Notion content:

### Read Tools

| Tool | Description |
|------|-------------|
| `getPage` | Retrieve a Notion page by ID |
| `getDatabase` | Retrieve a database by ID |
| `queryDatabase` | Query a database with filters and sorts |
| `getBlock` | Retrieve a block by ID |
| `listBlocks` | List all child blocks of a page or block |
| `searchPages` | Search across all pages and databases |

### Write Tools

| Tool | Description |
|------|-------------|
| `createPage` | Create a new page in a database or as a child of another page |
| `updatePage` | Update page properties or archive a page |
| `appendBlock` | Append new blocks to a page or block |
| `createDatabase` | Create a new database as a child of a page |

### Requires Approval ⚠️

| Tool | Description |
|------|-------------|
| `deletePage` | Permanently delete a page _(approval required)_ |

> Configure approval workflows in your MCPForge dashboard under **Governance → Approvals** to require human sign-off before destructive tools execute.

---

## Security Report

**Security Score: 79 / 100 · Verified**

| Dimension | Result |
|-----------|--------|
| Tool Quality Score | 78 / 100 |
| Read tools | 6 |
| Write tools | 4 |
| Approval-required tools | 1 |
| Governance controls | 3 / 5 |

Full report: [mcpforge.tech/verified/notion-mcp-mqks51f7](https://www.mcpforge.tech/verified/notion-mcp-mqks51f7)

---

## Generated with MCPForge

[MCPForge](https://mcpforge.tech) converts any OpenAPI spec into a hosted, governed MCP server in under 60 seconds.

- **Verify** any MCP server for free at [mcpforge.tech/verify](https://mcpforge.tech/verify)
- **Browse** the verified MCP directory at [mcpforge.tech/verified](https://mcpforge.tech/verified)
- **Generate** your own MCP server at [mcpforge.tech](https://mcpforge.tech)