Skip to content
MCP-BridgeMCP-Bridge
ProductivityOAuth2Official MCPScore: 78Verified by owner

Notion API MCP Server

Create and manage Notion pages, databases, and blocks through your AI agent.

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 OAuth2 variables, and restart.
  3. 3. 3 operations available including Create a page, Query a database, Get block children.
  4. 4. Quality score: 78/99 — good source quality and documentation coverage.

Overview

Category: Productivity

Auth: OAuth2

Endpoints: 3

Transport: STDIO

Command: npx -y @modelcontextprotocol/server-notion

Spec: v2022-06-28

Setup time: ~2 min (auth required)

Environment Variables

NOTION_TOKEN

Example: ntn_...

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": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion"
      ],
      "env": {
        "NOTION_TOKEN": "ntn_..."
      }
    }
  }
}
Deep link

Cursor

Settings → MCP Servers → Add

{
  "mcpServers": {
    "notion": {
      "url": "https://mcpbridge.org/config/notion.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": {
      "url": "https://mcpbridge.org/config/notion.json"
    }
  }
}

MCP Server Configuration

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

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y","@modelcontextprotocol/server-notion"],
      "env": {
      "NOTION_TOKEN": "ntn_..."
}
    }
  }
}

What You Can Build

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

  • Access 3 API operations through natural language
  • Read, create, and modify productivity 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

POST/v1/pages

Create a page

POST/v1/databases/{database_id}/query

Query a database

GET/v1/blocks/{block_id}/children

Get block children

Documentation →GitHub →

Authentication

This API requires OAuth2 authentication.

Set the required environment variables in your MCP client before using this server. Refer to the Notion API API documentation to obtain credentials.

Required environment variables:

  • NOTION_TOKEN

Spec Version

Version: 2022-06-28

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

Page last updated: June 13, 2026

Quality Score

78/99Good
  • +Official source (+30)
  • +Has documentation (+12)
  • +GitHub repo (+12)
  • +Auth type defined (+8)
  • +OpenAPI spec available (+8)
  • +3 endpoints (+8)

Build with Notion API

Get everything you need in one bundle: MCP config, cursor rules, and framework integration for Notion API.

View Notion + Python Productivity Stack→

Read the Guide

Step-by-step walkthrough for setting up and using the Notion API MCP server.

Notion APIMCP Setup Guide →

This listing is verified by the API owner.

Similar APIs

Other APIs in the Productivity category.

Linear API

Manage issues, projects, and workflows in Linear through your AI agent.

API Key

Platform API

The [REST API specification](https://www.ably.io/documentation/rest-api) for Ably.

Control API v1

Use the Control API to manage your applications, namespaces, keys, queues, rules, and more. Detailed information on using this API can be found in the Ably <a href="https://ably.com/documentation/control-api">developer documentation</a>. Control API is currently in Beta.

Adyen Test Cards API

The Test Cards API provides endpoints for generating custom test card numbers. For more information, refer to [Custom test cards](https://docs.adyen.com/development-resources/testing/create-test-cards) documentation.