makenotion/notion-mcp-server

解决的问题

该项目为 AI 代理与 Notion 工作区的交互提供了一种方式。通过实现 Model Context Protocol (MCP)，它将 Notion API 转换为 AI 客户端可自动发现和使用的工具集，使 LLM 能够搜索、读取和编辑 Notion 页面和数据库。

工作原理

该服务器充当 MCP 兼容 AI 客户端（如 Claude Desktop 或 Cursor）与 Notion API 之间的桥梁。它公开了 22 种不同的工具，AI 可使用这些工具执行查询数据源、检索页面元数据和移动页面等操作。为提高令牌效率，它还包含专门的工具，允许 AI 使用 Markdown 而非 Notion API 通常使用的复杂 JSON 块格式来读写页面内容。

适用人群

希望将自身 Notion 工作区与 AI 代理进行自托管连接，并且能够自行管理 API 令牌和本地服务器配置的开发者和 AI 高级用户。

亮点

• Markdown 支持：提供专门用于以 Markdown 格式读写页面的工具，以减少令牌使用量。
• 灵活的传输方式：支持标准输入/输出（STDIO）和可流式传输的 HTTP 传输，适用于基于 Web 的应用程序。
• 多租户能力：可通过令牌透传配置，实现单个部署服务多个 Notion 集成。
• 全面的工具集：提供 22 个工具，涵盖页面管理、数据库（数据源）查询和内容操作。