notion-mcp
Provides tools for managing tasks in a Notion kanban board, including creating tasks, querying tasks with optional status filters, and updating task status.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
notion-mcp
Personal Notion MCP server with domain-specific tools for task management and workspace integration. Wraps the Notion REST API with tools that encode workspace-specific structure (database IDs, templates, status values) so callers don't need to know the details.
Tools
Tool | Description |
| Create a task in the Task List kanban board |
| Query tasks, optionally filtered by status |
| Move a task to a new kanban column |
| Get a page's properties and metadata |
| Update properties on a page |
| Get a page's body content (blocks), converted to markdown |
| Replace a page's body content from markdown (full replace) |
Related MCP server: Notion MCP Server
Setup
Prerequisites
Python 3.12+
A Notion integration with access to the target workspace
Installation
git clone git@github.com:bramleyjl/notion-mcp.git ~/Projects/mcps/notion-mcp
cd ~/Projects/mcps/notion-mcp
pip install -e .Configuration
cp .env.example .env
# Edit .env and set NOTION_API_KEY to your Notion integration tokenGet a token at notion.so/my-integrations — create an internal integration and share your target databases with it.
Running
Intended to run as a persistent HTTP server on the home server (pangolin), so it's always available to Claude CLI and other MCP clients on the network.
notion-mcp --transport http --port 8766See deploy/ for systemd unit examples.
MCP Config
Primary (HTTP — pangolin): add to ~/.claude/settings.json:
"notion-mcp": {
"type": "http",
"url": "http://YOUR_SERVER_IP:8766/mcp"
}Local fallback (if pangolin is unavailable):
"notion-mcp": {
"type": "stdio",
"command": "notion-mcp",
"env": {
"NOTION_API_KEY": "your_token_here"
}
}Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Official Todoist MCP server. Manage tasks and projects. Hosted, no API key needed.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.209MIT
- AlicenseNot gradedqualityCmaintenanceStateless MCP server exposing the full Notion API as 33 tools, enabling users to manage pages, databases, blocks, comments, users, and file uploads using their own integration token.Apache 2.0
- FlicenseNot gradedqualityDmaintenanceAn MCP server that turns your Notion task list into an AI-optimized daily schedule, reading tasks with page content and priorities from an Eisenhower matrix, and writing a clean schedule back to Notion.-
- AlicenseNot gradedqualityDmaintenanceComprehensive MCP server for the Notion API. Provides 22 tools for full CRUD operations on pages, databases, blocks, users, and comments.8 npmMIT