notion-mcp

基本能力

产品定位

notion-mcp 是一个用于与 Notion API 集成的 MCP 服务器，主要用于管理个人待办事项列表。

核心功能

1. 任务管理：
2. 查看所有任务（show_all_todos）
3. 添加新任务（add_todo）
4. 更新任务状态（complete_todo）
5. Notion 集成：通过与 Notion API 的交互，实现对 Notion 数据库/页面的操作。
6. Claude Desktop 集成：支持通过 Claude Desktop 客户端进行交互。

适用场景

1. 个人待办事项管理
2. 团队任务协作
3. 与 Notion 集成的自动化工作流

工具列表

1. Smithery：用于自动安装 notion-mcp
2. Claude Desktop：客户端交互工具
3. Notion API：后端数据存储和管理

常见问题解答

1. 如何获取 Notion API 令牌？
2. 访问 https://www.notion.so/my-integrations 创建新的集成并获取 API 密钥。
3. 如何共享数据库/页面？
4. 在 Notion 工作区中打开数据库/页面，点击"..."菜单 → "Add connections"，然后选择您的集成。

使用教程

使用依赖

1. Python 3.11 或更高版本
2. 具有 API 访问权限的 Notion 账户
3. Notion 集成令牌
4. 用于管理待办事项列表的 Notion 页面
5. Claude Desktop 客户端

安装教程

1. 通过 Smithery 安装：

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude

1. 手动安装：

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp
uv venv
source .venv/bin/activate
uv pip install -e .

配置

1. 创建 .env 文件并配置 Notion 凭证：

NOTION_TOKEN=<your-notion-api-token>
PAGE_ID=<your-notion-page-id>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

1. 配置 Claude Desktop：

{
    "mcpServers": {
        "notion-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/username/Projects/Python/notion-mcp/src",
                "run",
                "server.py"
            ]
        }
    }
}

调试方式

1. 使用 show_all_todos 函数查看所有任务：

{
    "name": "show_all_todos",
    "arguments": {}
}

1. 使用 add_todo 函数添加新任务：

{
    "name": "add_todo",
    "arguments": {
        "task": "Your task description"
    }
}

1. 使用 complete_todo 函数更新任务状态：

{
    "name": "complete_todo",
    "arguments": {
        "task_id": "your-task-id"
    }
}

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。