# suekou/mcp-notion-server [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/suekou/mcp-notion-server  
**GitHub Stars:** 925  
**npm Downloads (last month):** 3917  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/suekou-mcp-notion-server

## Description
A Model Context Protocol server for connecting Notion to MCP-compatible clients

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `NOTION_API_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What suekou/mcp-notion-server MCP server does

The suekou/mcp-notion-server MCP server exposes Notion workspace operations through the Model Context Protocol. It can search for pages and data sources, read page content, inspect data source schemas, query data source items, and create new items from simple values.

Page editing covers paragraphs, headings, lists, to-dos, quotes, callouts, code blocks, dividers, and Markdown appends. Additional tools update page or block content, support batch updates, and provide access to lower-level Notion API operations for blocks, pages, databases, data sources, comments, and users.

The server targets Notion API version `2026-03-11` and follows Notion's current database and data source model. It also exposes prompts, resources, structured tool results, and optional MCP Apps for a Data Source Explorer and Page Workbench.

## How it works

An MCP host starts the server as a local Node.js process, typically through `npx`. The host passes a Notion internal integration token through the `NOTION_API_TOKEN` environment variable. Agents then invoke the exposed tools over MCP.

A practical workflow starts with `notion_find` to locate a page or data source. For pages, `notion_read_page` returns compact context with stable block IDs that can be used for later edits. For data sources, `notion_inspect_data_source` reveals the schema before a query or item creation request. Simplified tools handle common operations, while raw JSON tools are available when an operation requires a Notion API shape not covered by those helpers.

The integration can only access pages and databases shared with it. Sharing a page also gives the integration access to that page's children. Notion integration capabilities determine which classes of operations are available.

## Setup and configuration

Create an internal integration in the Notion integrations dashboard, then enable the capabilities required by the workflows you plan to use. Read content is needed for search, page reads, data source retrieval, and queries. Insert content enables page or item creation and block appends. Update content is needed for page, block, and data source schema changes. Comment and user capabilities are only needed for the corresponding tools.

Copy the integration's internal token and configure it as `NOTION_API_TOKEN` in the MCP host. A standard configuration runs `npx -y @suekou/mcp-notion-server`. A locally built checkout can instead run the generated `build/index.js` file with Node.js.

The project uses Node.js 22 or newer and pnpm for development. Local contributors can install dependencies with the frozen lockfile, build the project, run tests, and use the MCP inspector.

## Tools and capabilities

The suekou/mcp-notion-server MCP server includes capabilities for:

- Finding pages and data sources with `notion_find`.
- Reading pages with compact output and stable block identifiers.
- Inspecting schemas before data source operations.
- Querying data sources and creating items from simple values.
- Appending Markdown or structured content to pages.
- Updating content through individual or batch operations.
- Calling raw Notion API operations for advanced blocks, pages, databases, data sources, comments, and users.
- Using the optional Data Source Explorer and Page Workbench MCP Apps.

## Limitations and notes

The Notion integration must be granted access to each target page or database; an integration token alone does not provide workspace-wide access. Required Notion capabilities also vary by tool, so enabling only read access will not support creation or editing.

The simplified tools are intended for common workflows. Raw API tools may be necessary for operations or payloads outside the simplified interfaces. Comment and user operations require their respective Notion integration permissions. Restart the MCP host after changing its configuration.

_Full upstream README: https://allmcps.com/mcp/suekou-mcp-notion-server/readme_