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

1. 设置Python环境：

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

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

配置

1. 创建.env文件：

cp .env.example .env

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，请调整你的claude_desktop_config.json文件。前往 Claude Desktop -> 设置 -> 开发者 -> 编辑配置。现在添加Notion服务器配置。

{
    "mcpServers": {
        "notion-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/username/Projects/Python/notion-mcp/src" /* Path to your project */,
                "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": "Your task description"
    }
}

更新任务

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

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

贡献

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

许可证

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