Prismix
Community Productivity

Notion

Read + write Notion pages, databases, and blocks — the official-API surface as MCP tools.

907 stars 178 forks Last commit 3d ago Language TypeScript License MIT
Sign in to like, install, or save to a bundle → View on GitHub →

Install

npm install -g mcp-notion-server

Maintainer? Add the badge

Listed on Prismix ← shows on your README, links back here
[![Listed on Prismix](https://prismix.dev/api/badge/mcp/notion.svg)](https://prismix.dev/mcp/notion)

Claude Desktop / Cursor config

Drop into your claude_desktop_config.json or Cursor MCP settings. Replace the ${…} placeholders with your own values. 

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "mcp-notion-server"],
      "env": { "NOTION_API_TOKEN": "${NOTION_TOKEN}" }
    }
  }
}

About

Community Notion MCP server. Page + database search, block-level reads + writes, page creation, database row CRUD. Integration-token auth (admin in the Notion workspace adds the integration to specific pages).

Tags #notion #docs #knowledge-base #community

Recent releases (5)

All releases →
  • v2.0.2 Latest Jun 22, 2026 
    ## What's Changed
* Fix eager evaluation crash for is_empty operator on non-text properties by @mrpetabyte in https://github.com/suekou/mcp-notion-server/pull/84

## New Contributors
* @mrpetabyte made their first contribution in https://github.com/suekou/mcp-notion-server/pull/84

**Full Changelog**: https://github.com/suekou/mcp-notion-server/compare/v2.0.1...v2.0.2
    View on GitHub ↗
  • v2.0.1 Jun 22, 2026 
    ## What's Changed
* chore: add Dependabot config with 3-day cooldown by @suekou in https://github.com/suekou/mcp-notion-server/pull/74
* chore(deps): bump pnpm/action-setup from 4 to 6 by @dependabot[bot] in https://github.com/suekou/mcp-notion-server/pull/75
* chore(deps): bump actions/setup-node from 4 to 6 by @dependabot[bot] in https://github.com/suekou/mcp-notion-server/pull/76
* chore(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in https://github.com/suekou/mcp-notion-server/pull/77
* feat: add table block creation support to blockObjectSchema by @wintrover in https://github.com/suekou/mcp-notion-server/pull/81
* fix: pin MCP SDK to Zod v4 compatible version by @suekou in https://github.com/suekou/mcp-notion-server/pull/86

## New Contributors
* @dependabot[bot] made their first contribution in https://github.com/suekou/mcp-notion-server/pull/75
* @wintrover made their first contribution in https://github.com/suekou/mcp-notion-server/pull/81

**Full Changelog**: https://github.com/suekou/mcp-notion-server/compare/v2.0.0...v2.0.1
    View on GitHub ↗
  • Release v2.0.0 v2.0.0 May 5, 2026 
    ## Release Notes

### v2.0.0

This major release modernizes `@suekou/mcp-notion-server` for the latest Notion API and introduces a more AI-friendly MCP tool surface designed for practical agent workflows.

#### Highlights

- Updated Notion API support to `2026-03-11`.
- Migrated database-oriented workflows toward the new Notion Data Sources API.
- Added high-level AI-friendly tools for search, page reading, data source inspection, schema-aware querying, simple item creation, and content editing.
- Added Markdown append support for converting a safe Markdown subset into Notion blocks.
- Improved response handling with compact response modes, structured content, and tool errors that agents can self-correct from.
- Replaced `node-fetch` with native Node.js `fetch`, including timeout, retry, `Retry-After`, and structured Notion API error handling.
- Migrated the project from npm to pnpm.
- Updated runtime support to Node.js 22+.
- Added Biome-based linting and formatting.
- Added CI and publish workflows.
- Added React-based MCP apps for data source exploration and page workbench workflows.
- Expanded documentation for setup, configuration, tools, and recommended workflows.

#### New AI-Friendly Tools

- `notion_find`
- `notion_read_page`
- `notion_inspect_data_source`
- `notion_query_data_source_by_values`
- `notion_create_data_source_item_from_values`
- `notion_append_content`
- `notion_append_markdown`
- `notion_update_content`
- `notion_update_content_batch`

#### Notion API Changes

- Uses `Notion-Version: 2026-03-11`.
- Adds first-class support for data sources.
- Keeps `notion_retrieve_database` for discovering child `data_source_id` values from database containers.
- Updates append block children behavior to use `position`.
- Prefers `in_trash` over legacy `archived` fields where applicable.
- Adds Markdown conversion support for `data_source` responses.

#### Breaking Changes

- Node.js 22 or newer is now required.
- pnpm is now the supported package manager.
- Database-centric workflows should move to data source tools.
- Some tool arguments and response shapes have changed to align with the latest Notion API and MCP SDK patterns.

#### Migration Notes

Install with a Node.js 22+ runtime and use pnpm for local development:

```bash
pnpm install
pnpm run build
pnpm test
```

For AI-agent workflows, prefer the new high-level tools first:

1. `notion_find`
2. `notion_read_page` or `notion_inspect_data_source`
3. `notion_append_markdown`, `notion_append_content`, `notion_update_content`, or data source value-based tools
4. Use low-level block/page/data source tools only for advanced shapes not covered by the high-level tools.
    View on GitHub ↗
  • Release v1.2.4 v1.2.4 May 14, 2025 
    ## What's Changed
* adding node-fetch by @suekou in https://github.com/suekou/mcp-notion-server/pull/55


**Full Changelog**: https://github.com/suekou/mcp-notion-server/compare/v1.2.3...v1.2.4
    View on GitHub ↗
  • Release v1.2.3 v1.2.3 Apr 11, 2025
    View on GitHub ↗

Discussion (0)

Sign in to comment →

No comments yet. Sign in to start the discussion.

More Productivity servers