notion-mcp

这是一个简单的模型上下文协议（MCP）服务器，它与Notion API集成以管理个人待办事项列表。

演示

视觉指南

Notion MCP 查询 1

Notion MCP 查询 2

Notion MCP 查询 3

预备条件

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

设置

通过 Smithery 安装

要通过 Smithery 自动安装 Notion MCP for Claude Desktop：

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

1. 克隆仓库：

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp

2. 设置 Python 环境：

uv venv
source .venv/bin/activate
uv pip install -e .

3. 创建 Notion 集成：
   • 访问 https://www.notion.so/my-integrations
   • 创建新的集成
   • 复制 API 密钥
4. 将数据库/页面与集成共享：
   • 打开包含数据库/表格或页面的 Notion 工作区
   • 点击“...”菜单 → “添加连接”
   • 选择你的集成（按名称搜索）

配置

1. 创建 .env 文件：

cp .env.example .env

2. 在 .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"

3. 若要按预期使用 Claude Desktop，请调整 claude_desktop_config.json 文件。 前往 Claude Desktop -> 设置 -> 开发者 -> 编辑配置。现在添加 Notion 服务器配置。

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

开发

项目结构：

notion-mcp/
├── docs/
├── src/
│ └── server.py
├── .env
├── .python-version
├── README.md
├── pyproject.toml
└── uv.lock

支持功能

显示任务

要显示来自 Notion 工作区的所有任务，请使用 show_all_todos 函数：

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

添加任务

要向 Notion 工作区添加新任务，请使用 add_todo 函数：

{
    "name": "add_todo",
    "arguments": {
        "task": "您的任务描述"
    }
}

更新任务

要更新 Notion 工作区中的现有任务，请使用 complete_todo 函数：

{
    "name": "complete_todo",
    "arguments": {
        "task_id": "您的任务ID"
    }
}

贡献

1. 分叉仓库
2. 创建功能分支
3. 提交拉取请求

许可证

MIT 许可证。详情见 LICENSE 文件。