Skip to content
MCP-BridgeMCP-Bridge
DatabasesAuto-generatedScore: 34

Notion API MCP Server

Hello and welcome! To make use of this API collection collection as it's written, please duplicate [this database template](https://www.notion.so/8e2c2b769e1d47d287b9ed3035d607ae?v=dc1b92875fb94f10834ba8d36549bd2a). [Create an integration](https://www.notion.so/my-integrations) to retrieve an API

Quick Answer

  1. 1. The Notion API MCP server lets Claude, Cursor, and VS Code interact with the Notion API API through natural language.
  2. 2. Setup: Add the config to claude_desktop_config.json, set your environment variables, and restart.
  3. 3. 10 operations available including Retrieve a block, Delete a block, Update a block, and more.
  4. 4. Quality score: 34/99fair source quality and documentation coverage.

Overview

Category: Databases

Auth: None

Endpoints: 10

Transport: STDIO

Command: npx -y @mcp/notion-com

Spec: v1.0.0

Setup time: ~30 sec (no auth)

Environment Variables

NOTION_API_API_KEY

Example: your_notion_api_api_key

One-Click Install

Copy the snippet for your MCP client and paste it in — zero editing required.

Claude Desktop

Add to claude_desktop_config.json

{
  "mcpServers": {
    "notion-com": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp/notion-com"
      ],
      "env": {
        "NOTION_API_API_KEY": "your_notion_api_api_key"
      }
    }
  }
}
Deep link

Cursor

Settings → MCP Servers → Add

{
  "mcpServers": {
    "notion-com": {
      "url": "https://mcpbridge.org/config/notion-com.json"
    }
  }
}

Saves as .cursor/mcp.json in the download. Move it to your project root.

Deep link install →

VS Code

Use with MCP extension

{
  "mcpServers": {
    "notion-com": {
      "url": "https://mcpbridge.org/config/notion-com.json"
    }
  }
}

MCP Server Configuration

Add this to your claude_desktop_config.json or Cursor MCP settings.

{
  "mcpServers": {
    "notion-com": {
      "command": "npx",
      "args": ["-y","@mcp/notion-com"],
      "env": {
      "NOTION_API_API_KEY": "your_notion_api_api_key"
}
    }
  }
}

What You Can Build

With the Notion API MCP server, your AI assistant can:

  • Access 10 API operations through natural language
  • Read, create, and modify databases resources without writing HTTP requests
  • Chain multiple operations in a single conversation for complex workflows
  • Combine with other MCP servers for cross-tool automation

Endpoints

GET/v1/blocks/{id}

Retrieve a block

DELETE/v1/blocks/{id}

Delete a block

PATCH/v1/blocks/{id}

Update a block

GET/v1/blocks/{id}/children

Retrieve block children

PATCH/v1/blocks/{id}/children

Append block children

GET/v1/comments

Retrieve comments

GET/v1/databases/{id}

Retrieve a database

PATCH/v1/databases/{id}

Update a database

POST/v1/databases/{id}/query

Query a database

GET/v1/pages/{id}

Retrieve a Page

Authentication

No authentication required. This MCP server can be used without API keys.

Spec Version

Version: 1.0.0

Spec version published with the OpenAPI document. Config auto-updates when the spec changes.

Page last updated: June 13, 2026

Quality Score

34/99Fair
  • +Auto-generated (+12)
  • +OpenAPI spec available (+8)
  • +10 endpoints (+14)

Own this API?

Claim your listing to update description, links, and category — and get a verified badge.

Claim this listing →