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 自动为 Claude Desktop 安装 Notion MCP：

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 -> Settings -> Developer -> Edit Config。 现在添加 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. Fork 存储库
2. 创建功能分支
3. 提交 pull request

许可证

MIT 许可证。 有关详细信息，请参见 LICENSE 文件。