NO

Notion

Created 6 months ago

Notion MCP is a remote MCP server with easy installation and powerful tools for AI agents.

development documentation public

What is Notion?

This project implements an MCP server for the Notion API.

Documentation

Notion MCP Server# Installation

  1. Setting up Integration in Notion: Go to Notion Integrations and create a new internal integration or select an existing one.

  2. Connecting content to integration: Ensure relevant pages and databases are connected to your integration.

  3. Adding MCP config to your client:

  • Using npm:
  • Option 1: Using NOTION_TOKEN (recommended)
  • Option 2: Using OPENAPI_MCP_HEADERS (for advanced use cases)
  • Using Docker:
  • Option 1: Using the official Docker Hub image
  • Option 2: Building the Docker image locally

Transport Options

The Notion MCP Server supports two transport modes:

  • STDIO Transport (Default)
  • Streamable HTTP Transport

Authentication

The Streamable HTTP transport requires bearer token authentication.

Examples

  1. Using the instruction Comment "Hello MCP" on page "Getting started" will plan two API calls.
  2. The instruction Add a page titled "Notion MCP" to page "Development" will add a new page.

Server Config

{
  "mcpServers": {
    "notion-server": {
      "command": "npx",
      "args": [
        "notion"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: makenotion
Category: official
License: MIT
Tags:
development documentation public