Notion MCP Integration

Notion MCP Integration

site icon
2024.12.19 159
Python任务管理Notion 集成交流协作
Notion MCP Integration 是一个基于 Model Context Protocol (MCP) 的服务器,用于与 Notion API 集成,通过 Claude 管理个人待办事项列表。该项目是一个针对特定 Notion 待办事项列表结构的实现,适用于简单的任务管理场景。
View on GitHub

Overview

基本能力

产品定位

Notion MCP Integration 是一个专门为个人待办事项管理设计的工具,通过与 Notion API 的集成,实现任务的添加、查看和完成标记。

核心功能

  • 添加新的待办事项
  • 查看所有待办事项
  • 查看今天的任务
  • 标记任务为完成

适用场景

  • 个人任务管理
  • 简单的待办事项跟踪
  • 与 Claude 集成的自动化任务管理

工具列表

  • create_todo(): 创建新的待办事项
  • list_tools(): 列出可用的工具和选项
  • call_tool(): 调用特定工具处理任务

常见问题解答

  • 仅支持特定的 Notion 数据库结构
  • 仅支持“今天”或“以后”两种任务调度选项
  • 不支持复杂的数据库模式或自定义字段

使用教程

使用依赖

  • Python 3.10 或更高版本
  • Notion 账户
  • Notion 集成 API 密钥
  • 匹配上述结构的 Notion 数据库

安装教程

  1. 克隆仓库:
git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
  1. 设置 Python 环境:
python -m venv .venv
source .venv/bin/activate  # Windows 使用: .venv\Scripts\activate
uv pip install -e .
  1. 创建 Notion 集成并获取 API 密钥
  2. 将数据库与集成共享
  3. 创建 .env 文件并配置 API 密钥和数据库 ID

调试方式

  1. 直接运行服务器:
python -m notion_mcp
  1. 通过 Claude Desktop 自动运行(推荐)

基本命令

  • "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"

许可证

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