BACK TO MCP SERVERS
dataany

Notion

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

At a glance

Not tested yet
GitHub stars
36
Weekly downloads
1,730
Last commit
2026-11-21
Licence
Apache-2.0
Transport
stdio
Auth
api-key
Install
npx -y @n24q02m/notion
Stats checked 2026-11-21

What it does

Notion is an MCP server that lets an AI agent work with Notion pages, databases, blocks, and comments. It takes Markdown in and returns Markdown out, so the agent reads and writes human-readable content instead of raw JSON blocks. It is for people who want their agent to read and edit Notion content through an MCP client.

Tools it gives your agent

  • pages: page actions, such as getting a page.
  • databases: database actions, such as querying a database.
  • blocks: block actions, such as appending content to a block.
  • users: user actions, such as looking up the current user.
  • workspace: workspace actions, such as searching.
  • comments: comment actions, such as listing comments on a page.
  • content_convert: converts content between Markdown and blocks.
  • file_uploads: file upload actions, such as listing uploads.

Quick start

Run with npx and a Notion integration token from the Notion integrations page. The token starts with ntn_. Node.js 24 or later is required.

NOTION_TOKEN=ntn_your_token_here npx --yes @n24q02m/notion@latest

To start the remote HTTP server instead of stdio:

npx --yes @n24q02m/notion@latest --http

Add this to .mcp.json in your project root (Claude Code) or .cursor/mcp.json (Cursor):

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

Replace each YOUR_ value with your own, and delete the variables you do not use.

Environment variables

  • NOTION_TOKEN: the Notion integration token the stdio server requires.

Example prompts

  • Get the page with this ID and show me its content as Markdown.
  • Query the roadmap database and list the first five entries.
  • Append a heading called Update to this block.
  • Search the workspace for roadmap.

What to watch out for

  • The stdio server requires a Notion integration token.
  • The token comes from the Notion integrations page and starts with ntn_.
  • Node.js 24 or later is required to run with npx.
  • The README lists no other limits.

Not tested by tools4agents yet. Read the source repository before you install it.

GitHub SourceGitHub Stars
Last verified 2026-11-21

Similar tools