Notion Integration MCP Server 使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将 Notion 数据库中的待办事项列表连接到 Claude 等大型语言模型 (LLM) 客户端。通过此服务器，用户可以使用自然语言指令，例如 "添加一个待办事项" 或 "查看今天的任务"，直接与 Notion 中的待办事项列表进行交互。

主要功能点

添加待办事项: 允许用户通过 Claude 添加新的待办事项到 Notion 数据库。
查看待办事项: 支持查看所有待办事项或仅查看今天需要完成的待办事项。
完成待办事项: 允许用户标记 Notion 中的待办事项为已完成。
简单的任务管理: 专注于个人简单的待办事项管理，支持任务标题、计划时间（今天或稍后）、完成状态等基本属性。

安装步骤

克隆仓库:

git clone https://github.com/danhilse/notion_mcp.git
cd notion_mcp

配置 Python 环境:

python -m venv .venv
source .venv/bin/activate  # 或者 Windows: .venv\Scripts\activate
uv pip install -e .

创建 Notion 集成 (API 密钥):
- 访问 https://www.notion.so/my-integrations
- 创建一个新的集成
- 复制生成的 API 密钥
分享数据库给集成:
- 打开你的 Notion 待办事项数据库
- 点击 "..." 菜单 → "添加连接"
- 选择你创建的集成

创建 '.env' 文件: 在项目根目录下创建 '.env' 文件，并填入你的 Notion API 密钥和数据库 ID：

NOTION_API_KEY=你的-API-密钥
NOTION_DATABASE_ID=你的-数据库-ID

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到此服务器，你需要配置客户端的 MCP 服务器设置。以下是针对 Claude Desktop 的配置示例：

{
  "mcpServers": {
    "notion-todo": {  // 服务器名称，可以自定义
      "command": "/path/to/your/notion-mcp/.venv/bin/python", // Python 解释器路径，根据你的实际虚拟环境路径修改
      "args": ["-m", "notion_mcp"], // 启动服务器的参数，固定为 ["-m", "notion_mcp"]
      "cwd": "/path/to/your/notion-mcp" // 项目根目录路径，根据你的实际项目路径修改
    }
  }
}

注意:

请将 '/path/to/your/notion-mcp' 替换为你的 'notion-mcp' 项目的实际绝对路径。
请将 '/path/to/your/notion-mcp/.venv/bin/python' 替换为你项目虚拟环境中 Python 解释器的实际绝对路径。

基本使用方法

配置完成后，在 Claude 中可以使用以下自然语言指令与 Notion 待办事项列表进行交互：

"Show all my todos" (显示所有待办事项)
"What's on my list for today?" (显示今天的待办事项)
"Add a todo for today: check emails" (添加一个今天完成的待办事项：检查邮件)
"Add a task for later: review project" (添加一个稍后完成的待办事项：回顾项目)

限制:

该服务器目前仅适用于预定义的简单 Notion 数据库结构。
不支持复杂的数据库模式或自定义字段。

关键词

Notion, 待办事项, 任务管理, Claude, 效率工具

关键词