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
npx -y @n24q02m/notion
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.
Similar tools
Memory
A knowledge graph that persists facts across sessions, so an agent can recall context after the conversation ends.
DBHub
Token-efficient MCP server for PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, SQLite
PostgreSQL
Read only SQL access with schema introspection, so an agent can answer questions about your data without guessing column names.
Supabase MCP Server
Connects AI assistants directly to Supabase projects to manage database tables, query data, run migrations, and control edge functions.