Notion Workflow MCP
This server provides personal workflow and knowledge management through 19 MCP tools integrating with Notion databases for task tracking, note-taking, and productivity reporting.
Task Management
Create, list, retrieve, update, and search tasks with properties like status (to-do/in-progress/done/on-hold), priority, project, due date, and tags
Start tasks (logs start time), mark them complete with optional summaries, and append content to task bodies
Subtask Management
Retrieve and update subtasks embedded within a task's Notion page, including name, status, and priority
Note Management
Create, list, retrieve, search, and append to notes
Categorize notes by type (meeting, idea, reference, quick note) and tags
Automatically summarize AI conversations into structured notes
Schedule spaced repetition (Ebbinghaus) reviews based on note creation dates
Reporting & Aggregations
Overview dashboard: Task counts by status
Today's tasks: Tasks due today plus all in-progress tasks, sorted by priority
Daily standup: Auto-generated report of yesterday's completions, today's plans, and blockers
Weekly review: Recap of completed/in-progress tasks and notes created for the current or past week
Search: Full-text search across both tasks and notes databases.
Provides tools for managing personal workflows and knowledge systems within Notion, including task lifecycle management, project-based organization with subtasks, and the ability to capture and summarize notes from conversations into Notion databases.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Notion Workflow MCPcapture a task to 'Refactor API' for the Backend project due this Friday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
notion-workflow-mcp
Personal workflow management via Claude CLI + Notion API, built as an MCP Server.
Features
19 MCP tools — task lifecycle, subtask management, note-taking, aggregations
12 skills — slash commands + natural language triggers, globally installable
2 Notion databases — 工作流库 (tasks) + 笔记库 (notes), independent
Project-based task management — tasks belong to projects, with embedded subtasks (priority + status)
Conversation-to-note —
/noteauto-summarizes AI conversations into structured notesEbbinghaus review —
/recallschedules spaced repetition based on note creation dates
Requirements
Python 3.11+
uv (recommended) or pip
Notion account + Integration token
Setup
1. Clone & install
git clone <repo-url>
cd notion-workflow-mcp
uv venv --python python3.12
uv pip install -e .2. Configure environment
cp .env.example .env
# Fill in: NOTION_TOKEN, WORKFLOW_DATABASE_ID, NOTES_DATABASE_IDNOTION_TOKEN: notion.so/my-integrations → New integration → copy tokenDatabase IDs: Open database in Notion → URL 中
notion.so/<database_id>?v=...
3. Share databases with Integration
In Notion: open each database → ... → Connections → select your integration.
4. Initialize database schema
python scripts/init_databases.pyAuto-adds required properties (状态, 优先级, 项目, 截止日期, 标签, 备注) to existing databases.
5. Register MCP Server
claude mcp add notion-workflow -- /path/to/.venv/bin/python /path/to/server.pyOr add to ~/.claude/settings.json:
{
"mcpServers": {
"notion-workflow": {
"command": "/path/to/notion-workflow-mcp/.venv/bin/python",
"args": ["/path/to/notion-workflow-mcp/server.py"]
}
}
}6. Install skills
Skills defined in .claude/skills/ provide slash commands and natural language triggers. In-repo they're auto-discovered; to use from any directory, run:
bash scripts/install-skills.shThis copies all skills to ~/.claude-internal/skills/. Restart Claude Code session to take effect.
Workflow
# Create a task
/capture 重构Notion MCP -p MCP改造 -d 2026-03-28
# Add subtasks
/subtask abc123 去掉关联功能 -pri 高
/subtask abc123 增加项目字段
# View tasks
/task_list
# Start working
/status abc123 doing 去掉关联功能
# Save conversation knowledge
/note
# Mark done
/status abc123 done 去掉关联功能
# Update progress
/progress abc123
# Daily standup
/standup
# Weekly review
/review this week
# Ebbinghaus review
/recallSkills
Skill | Trigger | Description |
|
| Quick-create a task |
|
| Add subtask to a task |
|
| View incomplete tasks by project |
|
| Change task/subtask status (atomic) |
|
| Update subtask detail |
|
| Summarize & save progress |
|
| Summarize conversation to note |
|
| Search tasks and notes |
|
| Daily standup report |
|
| Date-range review report |
|
| Ebbinghaus spaced repetition |
|
| Extract task + subtasks from conversation |
MCP Tools
Group | Tools |
Workflow |
|
Subtasks |
|
Notes |
|
Aggregations |
|
Database Schema
工作流库 (Tasks)
名称 · 状态 · 优先级 · 项目 · 截止日期 · 标签 · 备注
Subtasks are embedded in task page body as a table:
子目标 | 优先级 | 状态 |
功能A | 🟡 高 | ⬜ 待办 |
功能B | 🟢 普通 | 🔄 进行中 |
功能C | 🔴 紧急 | ✅ 完成 |
Each subtask can have a detail section (heading_3 + paragraphs) below the table.
笔记库 (Notes)
名称 · 类型 (会议记录/想法/参考/速记) · 标签
Project Structure
├── server.py # FastMCP server entry
├── notion/
│ ├── client.py # Notion API client
│ └── models.py # Pydantic models & enums
├── tools/
│ ├── workflow.py # Task management tools
│ ├── notes.py # Note tools
│ └── aggregations.py # Standup, review, overview
├── .claude/skills/ # 12 skills (source of truth)
└── scripts/
├── init_databases.py # Database schema setup
└── install-skills.sh # Install skills globallyResources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wauwaya/notion-workflow-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server