Notion MCP Integration

Notion MCP Integration

site icon
2025.01.19 9
Python待办事项管理Notion 集成交流协作
Notion MCP Integration 是一个基于 Model Context Protocol (MCP) 的服务,专门用于与 Notion API 集成,管理个人待办事项列表。该项目针对特定的 Notion 数据库结构设计,支持基本的待办事项管理功能,如添加任务、查看任务、标记任务完成等。
View on GitHub

Overview

基本能力

产品定位

Notion MCP Integration 是一个个人待办事项管理工具,通过 Claude 与 Notion API 集成,实现简单的任务管理功能。

核心功能

  • 添加新的待办事项(包括描述和链接)
  • 查看所有待办事项
  • 标记任务为完成状态
  • 为任务添加外部资源链接

适用场景

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

工具列表

  • Notion API:用于与 Notion 数据库交互
  • Claude Desktop:通过 MCP 协议与服务器通信

常见问题解答

  • 仅支持特定的 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 自动运行(推荐)

许可证

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