mcpField
N
notion-mcp

notion-mcp

本地服务
github.com/Badhansen记忆与知识3162 周前更新
代码仓库

关于 notion-mcp

notion-mcp 是一个简单的 MCP 服务，通过 Notion API 管理个人待办清单。它面向希望在 Claude Desktop 中查看、添加和完成 Notion 任务的用户。项目基于 Python 实现，配置方式直接。

主要功能

  1. 01查询 Notion 中的全部待办任务
  2. 02添加新的待办任务
  3. 03通过任务 ID 标记任务为完成
  4. 04基于 .env 文件配置 Notion 凭据

适用场景

  1. 01在 Claude Desktop 中查看个人待办清单
  2. 02通过自然语言语句添加任务到 Notion 页面
  3. 03标记已完成的任务并同步到 Notion

MCP 相关

该服务以 MCP 服务形式运行，向 Claude Desktop 等 MCP 客户端暴露 show_all_todos、add_todo 与 complete_todo 三个工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "notion-mcp-badhansen": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

notion-mcp

Ask DeepWiki

Trust Score smithery badge

一个简单的模型上下文协议（MCP）服务，可与 Notion API 集成，用于管理我的个人待办清单。

演示

演示

可视化指南

Notion MCP 查询 1

Notion MCP 查询 1

Notion MCP 查询 2

Notion MCP 查询 1

Notion MCP 查询 3

Notion MCP 查询 1

前提条件

  • 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 集成：
  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 -> Settings -> Developer -> Edit Config。然后添加 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. Fork 仓库
  2. 创建功能分支
  3. 提交拉取请求

许可证

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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。