Skip to content

notion

Apache-2.0★ 36updated 14 Nov 2026

Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.

What can you do with notion?

  • Markdown in, Markdown out -- human-readable content instead of raw JSON blocks
  • 8 composite tools, 39 actions -- one call instead of chaining 2+ atomic Notion endpoints (plus config and help)
  • Auto-pagination and bulk operations -- no manual cursor handling or looping
  • Tiered token optimization -- ~77% reduction via compressed descriptions + on-demand help tool
  • Dual transport -- local stdio (integration token) or remote HTTP (per-user or shared bearer token)

Features as listed in the project's README, checked 16 Nov 2026.

About notion

Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.

Opening text of the project's README, checked 16 Nov 2026.

Install

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/notion"
      ],
      "env": {
        "NOTION_TOKEN": "<your NOTION_TOKEN>"
      }
    }
  }
}

Config as documented in its source, checked 16 Nov 2026. Placeholders such as API keys are the project's own: replace them with your values.

Setup documented for

Tools (10)

pagesnotion pages [flags]
databasesnotion databases [flags]
blocksnotion blocks --block-id
usersnotion users
workspacenotion workspace [flags]
commentsnotion comments [flags]
content_convertnotion contentconvert --direction --content `
file_uploadsnotion fileuploads [flags]`
confignotion config-tool
helpnotion help

Tool names from the README, checked 16 Nov 2026.

notion compared with other Notion servers

ServerLicenceToolsLast commitStars
notionApache-2.01014 Nov 202636
easy-notion-mcpMIT4311 Sept 202655
Notion Large File UploadMIT328 Oct 202613

Every value is a checked fact on that server's own page. This is a comparison of facts, not a ranking.

Verified facts

Maintainer
n24q02m

Source · checked 16 Nov 2026

Licence
Apache-2.0

Source · checked 16 Nov 2026

Transport
  • stdio

Source · checked 16 Nov 2026

Required settings
Environment variables: NOTION_TOKEN

Source · checked 16 Nov 2026

Setup documented for
  • Claude Code
  • Cursor
  • Codex
  • OpenCode

Source · checked 16 Nov 2026

Repository
github.com/n24q02m/notion

Source · checked 16 Nov 2026

Package
@n24q02m/notion (npm)

Source · checked 16 Nov 2026

Latest version
2.43.0

Source · checked 16 Nov 2026

Last commit
14 Nov 2026

Source · checked 16 Nov 2026

GitHub stars
36

Source · checked 16 Nov 2026

Open issues
1

Source · checked 16 Nov 2026

Each value links to where it was found and shows the date it was checked. How we verify

Frequently asked questions

What does notion do?

Markdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.

Which MCP clients does notion document setup for?

Its README documents setup for Claude Code, Cursor, Codex, OpenCode.

How do I install notion?

Add the install config shown on this page to your MCP client's configuration; the package is @n24q02m/notion (npm). Check the README for client-specific steps.

What licence is notion under?

Apache-2.0, as reported by the repository on 16 Nov 2026.

Is notion still maintained?

The last commit was on 14 Nov 2026, and the repository had 1 open issues.

What settings does notion need?

Environment variables: NOTION_TOKEN.

What tools does notion expose?

10 tools: pages, databases, blocks, users, workspace, comments, content_convert, file_uploads, config, help.

More Notion MCP servers