Skip to main content
Glama
enesjakozh

notion-mcp-server

by awkoy
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Remote
MIT License
184
139

Not MCP 服务器

执照TypeScript模型上下文协议 铁匠徽章 NPM 下载星星

Notion MCP 服务器是一个模型上下文协议 (MCP) 服务器实现，使 AI 助手能够与 Notion 的 API 进行交互。这款生产就绪的服务器提供了一整套工具和端点，用于通过自然语言交互读取、创建和修改 Notion 内容。

🚧积极开发：数据库支持现已推出！评论和用户管理工具也已添加。如果您觉得这个项目有用，请考虑点个星——这有助于我了解这项工作对社区的价值，并激励我们进一步开发。

📑 目录

Related MCP server: SystemPrompt MCP Notion Server

🚀 入门与集成

设置过程

  1. 获取 Not API 密钥

  2. 为您的页面启用集成

    • 在 Notion 中选择一个现有页面或创建一个新页面

    • 点击右上角的“...”菜单

    • 前往“连接”

    • 从列表中查找并启用您的集成概念页面连接

  3. 选择您的集成方法

    • 根据您首选的 MCP 客户端，遵循以下集成选项之一

  4. 让你的人工智能助手与 Notion 互动

    • “创建一个包含今日任务的新页面”

    • “在 Notion 中更新我的会议记录”

    • “将项目符号添加到我的会议记录页面”

    • “创建一个新的数据库来跟踪项目”

    • “向我的任务数据库添加新条目”

    • “向我的项目页面添加评论”

    • “显示此文档的所有评论”

    • “列出我的工作区中的所有用户”

    • “获取特定用户的信息”

光标集成

方法 1：使用 mcp.json

  1. 在您的项目目录中创建或编辑.cursor/mcp.json文件：

{ "mcpServers": { "notion-mcp-server": { "command": "env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx", "args": ["-y", "notion-mcp-server"] } } }

  1. 用您的实际 Notion API 密钥和页面 ID 替换YOUR_KEY和YOUR_PAGE_ID

  2. 重新启动 Cursor 以应用更改

方法二：手动模式

  1. 打开 Cursor 并转到“设置”

  2. 导航到“MCP”或“模型上下文协议”部分

  3. 单击“添加服务器”或同等按钮

  4. 在相应的字段中输入以下命令：

env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx -y notion-mcp-server

  1. 用您的实际 Notion API 密钥和页面 ID 替换YOUR_KEY和YOUR_PAGE_ID

  2. 保存设置并根据需要重新启动 Cursor

Claude 桌面集成

  1. 在您的配置目录中创建或编辑mcp.json文件：

{ "mcpServers": { "notion-mcp-server": { "command": "npx", "args": ["-y", "notion-mcp-server"], "env": { "NOTION_TOKEN": "YOUR_KEY", "NOTION_PAGE_ID": "YOUR_PAGE_ID" } } } }

  1. 用您的实际 Notion API 密钥和页面 ID 替换YOUR_KEY和YOUR_PAGE_ID

  2. 重新启动 Claude Desktop 以应用更改

🌟 功能

  • 📝 Notion 集成- 与 Notion 数据库、页面和块进行交互

  • 🔌 通用 MCP 兼容性- 适用于所有 MCP 客户端，包括 Cursor、Claude Desktop、Cline 和 Zed

  • 🔍 数据检索- 从 Notion 页面、块和数据库获取信息

  • ✏️ 内容创建- 创建和更新 Notion 页面和区块

  • 📊 区块管理- 在 Notion 页面中附加、更新和删除区块

  • 💾 数据库操作- 创建、查询和更新数据库

  • 🔄 批量操作- 在单个请求中执行多个操作

  • 🗑️ 存档和恢复- 存档和恢复 Notion 页面

  • 🔎 搜索功能- 按标题搜索 Notion 页面和数据库

  • 💬 评论管理——获取、创建和回复页面和讨论的评论

  • 👥 用户管理- 检索工作区用户和用户信息

📚 文档

可用工具

该服务器提供了以下与 Notion 交互的整合工具：

notion_pages

全面的页面操作工具，包括：

  • 创建具有指定内容的新页面

  • 更新页面属性

  • 存档页面（移至垃圾箱）

  • 恢复之前存档的页面

  • 按标题搜索页面

示例操作：

{ "payload": { "action": "create_page", // One of: "create_page", "archive_page", "restore_page", "search_pages", "update_page_properties" "params": { // Parameters specific to the chosen action } } }

notion_blocks

完整的区块操作工具包包括：

  • 检索块内容

  • 获取子块

  • 将新块附加到父块

  • 更新现有区块

  • 删除块

  • 执行批量操作（追加、更新、删除、混合）

示例操作：

{ "payload": { "action": "append_block_children", // One of: "append_block_children", "retrieve_block", "retrieve_block_children", "update_block", "delete_block", "batch_append_block_children", "batch_update_blocks", "batch_delete_blocks", "batch_mixed_operations" "params": { // Parameters specific to the chosen action } } }

notion_database

用于数据库交互的强大工具，包括：

  • 使用自定义属性创建新数据库

  • 使用过滤器和排序查询数据库

  • 更新数据库结构和属性

示例操作：

{ "payload": { "action": "create_database", // One of: "create_database", "query_database", "update_database" "params": { // Parameters specific to the chosen action } } }

notion_comments

用于管理 Notion 内容评论的工具：

  • 从页面和区块中检索评论

  • 向页面添加新评论

  • 回复现有讨论

示例操作：

{ "payload": { "action": "get_comments", // One of: "get_comments", "add_page_comment", "add_discussion_comment" "params": { // Parameters specific to the chosen action } } }

notion_users

访问用户信息的工具：

  • 列出所有工作区用户

  • 获取特定用户的详细信息

  • 检索有关当前机器人用户的信息

示例操作：

{ "payload": { "action": "list_users", // One of: "list_users", "get_user", "get_bot_user" "params": { // Parameters specific to the chosen action } } }

可用资源

服务器目前不公开任何资源，而是专注于基于工具的操作。

🛠 开发

  1. 克隆存储库

    git clone https://github.com/awkoy/notion-mcp-server.git cd notion-mcp-server

  2. 安装依赖项

    npm install

  3. 设置环境变量

    • 创建.env文件：

      NOTION_TOKEN=your_notion_api_key NOTION_PAGE_ID=your_notion_page_id

  4. 构建项目

    npm run build

  5. 运行检查器

    npm run inspector

🔧 技术细节

  • 使用 TypeScript 和 MCP SDK（版本 1.7.0+）构建

  • 使用官方 Notion API 客户端（@notionhq/client v2.3.0+）

  • 遵循模型上下文协议规范

  • 实现对 Notion 页面、块和数据库进行 CRUD 操作的工具

  • 支持高效的批量操作，以优化性能

  • 使用 Zod 模式验证输入/输出

❓ 故障排除

  • 常见问题

    • 身份验证错误：确保您的 Notion 令牌具有正确的权限，并且已为您的页面/数据库启用集成

    • 页面访问问题：确保您的集成已添加到您尝试访问的页面

    • 速率限制：Notion API 有速率限制 - 使用批处理操作来优化请求

  • 获取帮助

🤝 贡献

欢迎贡献代码！欢迎提交 Pull 请求。

  1. 分叉存储库

  2. 创建你的功能分支（ git checkout -b feature/amazing-feature ）

  3. 提交您的更改（ git commit -m 'Add some amazing feature' ）

  4. 推送到分支（ git push origin feature/amazing-feature ）

  5. 打开拉取请求

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

One-click Deploy
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/awkoy/notion-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server