# Notion MCP Server (MCP server)

> Notion MCP Server is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. This project implements an MCP server for the Notion API. It has 4,677 GitHub stars, is released under the MIT license and runs locally with npx -y @notionhq/notion-mcp-server.

This project implements an MCP server for the Notion API. Version 2.0.0 migrates to the Notion API 2025-09-03 which introduces data sources as the primary abstraction for databases.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/makenotion/notion-mcp-server |
| GitHub stars | 4,677 |
| License | MIT |
| Language | TypeScript |
| Transport | stdio |
| Packages | npm: @notionhq/notion-mcp-server |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v2.1.0 (Jan 31, 2026) |
| Last commit | Sep 20, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "notion-mcp-server-makenotion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env NOTION_TOKEN=your-value --transport stdio notion-mcp-server-makenotion -- npx -y @notionhq/notion-mcp-server
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "notion-mcp-server-makenotion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "notion_token",
      "description": "NOTION_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "notion-mcp-server-makenotion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "${input:notion_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `NOTION_TOKEN` (secret): Shown in the README's example configuration.

## Similar MCP servers

- [PraisonAI](https://appsgit.com/mcp-servers/praisonai): AI Agents Framework with Self Reflection and MCP support. (9,293 stars, MIT)
- [Basic Memory](https://appsgit.com/mcp-servers/basic-memory): Local-first knowledge management with bi-directional LLM sync via Markdown files. (4,356 stars, AGPL-3.0)
- [Kaneo](https://appsgit.com/mcp-servers/kaneo): Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients. (9,601 stars, MIT, official, needs API key)
- [Excel MCP Server](https://appsgit.com/mcp-servers/excel-mcp-server): Create and edit Excel files with AI: charts, PivotTables, formulas. (4,264 stars, MIT)
- [Windows MCP](https://appsgit.com/mcp-servers/windows-mcp): An MCP Server for computer-use in Windows OS. (10,380 stars, MIT)
- [Davinci Resolve MCP](https://appsgit.com/mcp-servers/davinci-resolve-mcp): MCP server integration for DaVinci Resolve Studio. (3,774 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/notion-mcp-server-makenotion
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.