能力标签

🔌 MCP 🤖 Agent 🔄 工作流 🐳 Docker 💻 CLI 🔗 REST API 🧬 Embedding 🧠 Claude 🕸 采集

🔌

MCP工具

Notion MCP服务器

基于 TypeScript · 让 AI 助手直接操作你的系统与工具

英文名：better-notion-mcp

⭐ 30 Stars 🍴 10 Forks 💻 TypeScript 📄 MIT 🏷 AI 7.8分

7.8AI 综合评分

Notion集成MCP工具AI代理MarkdownClaude扩展

⬇ 下载源码 ZIP ⚙️ 配置说明

✦ AI Skill Hub 推荐

AI Skill Hub 推荐使用：Notion MCP服务器是一款优质的MCP工具。AI 综合评分 7.8 分，在同类工具中表现稳健。如果你正在寻找可靠的MCP工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

Notion MCP服务器是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 Notion MCP服务器，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。Notion MCP服务器提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 Notion MCP服务器评为 AI 评分 7.8 分，属于同类工具中的优质选择。

📋 工具概览

为AI代理提供Markdown优先的Notion API服务。通过10个复合工具替代基础API调用，简化Notion与Claude、Cursor等AI工具的集成。适合需要自动化Notion操作和知识库管理的开发者。

Notion MCP服务器是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 30

开发语言

TypeScript

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

MIT

AI 综合评分

7.8 分

工具类型

MCP工具

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/n24q02m/better-notion-mcp

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "notion-mcp---": {
      "command": "npx",
      "args": ["-y", "better-notion-mcp"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 Notion MCP服务器 执行以下任务...
Claude: [自动调用 Notion MCP服务器 MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "notion_mcp___": {
      "command": "npx",
      "args": ["-y", "better-notion-mcp"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 44/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

Better Notion MCP

mcp-name: io.github.n24q02m/better-notion-mcp

Markdown-first Notion API server for AI agents -- 10 composite tools replacing 28+ endpoint calls

<details> <summary><strong>Sister projects from n24q02m</strong> (click to expand)</summary>

Project	Tagline	Tag
[better-code-review-graph](https://github.com/n24q02m/better-code-review-graph)	Knowledge graph for token-efficient code reviews -- fixed search, configurabl...	MCP
[better-email-mcp](https://github.com/n24q02m/better-email-mcp)	IMAP/SMTP email server for AI agents -- 6 composite tools with multi-account ...	MCP
[better-godot-mcp](https://github.com/n24q02m/better-godot-mcp)	Composite MCP server for Godot Engine -- 17 mega-tools for AI-assisted game d...	MCP
[better-notion-mcp](https://github.com/n24q02m/better-notion-mcp)	Markdown-first Notion API server for AI agents -- 10 composite tools replacin...	MCP
[better-telegram-mcp](https://github.com/n24q02m/better-telegram-mcp)	MCP server for Telegram with dual-mode support: Bot API (httpx) for quick bot...	MCP
[claude-plugins](https://github.com/n24q02m/claude-plugins)	Full documentation: mcp.n24q02m.com — unified docs for all 8 servers + the mc...	Marketplace
[imagine-mcp](https://github.com/n24q02m/imagine-mcp)	Production-grade MCP server for image and video understanding + generation ac...	MCP
[jules-task-archiver](https://github.com/n24q02m/jules-task-archiver)	Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a...	Tooling
[mcp-core](https://github.com/n24q02m/mcp-core)	Unified MCP Streamable HTTP 2025-11-25 transport, OAuth 2.1 Authorization Ser...	MCP
[mnemo-mcp](https://github.com/n24q02m/mnemo-mcp)	Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi...	MCP
[qwen3-embed](https://github.com/n24q02m/qwen3-embed)	Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF	Library
[skret](https://github.com/n24q02m/skret)	Secrets without the server.	CLI
[web-core](https://github.com/n24q02m/web-core)	Shared web infrastructure package for search, scraping, HTTP security, and st...	Library
[wet-mcp](https://github.com/n24q02m/wet-mcp)	Open-source MCP Server for web search, content extraction, library docs & mul...	MCP

</details>

Features

Markdown in, Markdown out -- human-readable content instead of raw JSON blocks
10 composite tools with 44 actions -- one call instead of chaining 2+ atomic endpoints
Auto-pagination and bulk operations -- no manual cursor handling or looping
Tiered token optimization -- ~77% reduction via compressed descriptions + on-demand help tool
Dual transport -- local stdio (token) or remote HTTP (OAuth 2.1, no token needed)

Build from Source

git clone https://github.com/n24q02m/better-notion-mcp.git
cd better-notion-mcp
bun install
bun run dev

Configuration

Variable	Required	Default	Description
`NOTION_TOKEN`	Yes (stdio)	-	Notion integration token
`TRANSPORT_MODE`	No	`stdio`	Set to `http` for remote mode
`PUBLIC_URL`	Yes (http)	-	Server's public URL for OAuth redirects
`NOTION_OAUTH_CLIENT_ID`	Yes (http)	-	Notion Public Integration client ID
`NOTION_OAUTH_CLIENT_SECRET`	Yes (http)	-	Notion Public Integration client secret
`DCR_SERVER_SECRET`	Yes (http)	-	HMAC secret for stateless client registration
`PORT`	No	`8080`	Server port

🎯 aiskill88 AI 点评 A 级 2026-05-24

创新的MCP实现，Markdown优先设计符合AI友好原则。复合工具设计减少API调用，提升效率。生态适配完整，但社区活跃度需观察。

⚡ 核心功能

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

👥 适合人群

Claude Desktop / Claude Code 用户AI 工具开发者需要扩展 AI 能力的专业人士自动化工程师

🎯 使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

⚖️ 优点与不足

✅ 优点

+MIT 协议，可免费商用
+标准化 MCP 协议，生态互联性强
+与 Claude 官方生态无缝对接
+即插即用，配置简单快捷

⚠️ 不足

−依赖 Claude 客户端，非 Claude 用户无法使用
−MCP 协议仍在持续演进，接口可能变更
−需要一定的配置步骤

⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

🔗 相关工具推荐

AI工程师中心

MCP工具

MCP 服务器资源汇总

精心策划的Model Context Protocol服务器列表，汇集AI工具生态中的优质MCP服务实现。面向Claud

🧩 你可能还需要

基于当前 Skill 的能力图谱，自动补全的工具组合

技能寻求者

MCP · Agent · 工作流

natively-cluely-ai-assistant — Claude Skill 中文使用文档

免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。

开源AI工具：RAG知识库系统

基于Vue.js前端的RAG知识库系统，提供高效的知识检索和生成功能，助力AI应用开发

total-agent-memory MCP工具

为Claude Code和Codex CLI提供持久化记忆功能的开源MCP工具。自动提取知识图谱，支持多轮对话上下文保留，适合需要长期记忆和

❓ 常见问题 FAQ

支持哪些Notion操作？−

支持数据库查询、页面创建更新、属性管理等核心操作，通过10个复合工具封装常见AI场景。

如何与Claude集成？+

MCP 是什么？和普通 API 有什么区别？+

我需要编程基础才能使用这个 MCP 工具吗？+

这个工具支持 Claude Code 吗？还是只有 Claude Desktop？+

MCP 工具是否会访问我的本地文件或数据？+

多个 MCP 工具可以同时使用吗？+

💡 AI Skill Hub 点评

总体来看，Notion MCP服务器是一款质量良好的MCP工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。

⬇️ 获取与下载

⬇ 下载源码 ZIP

✅ MIT 协议 · 可免费商用 · 直接从 aiskill88 服务器下载，无需跳转 GitHub

📚 深入学习 Notion MCP服务器

查看分步骤安装教程和完整使用指南，快速上手这款工具

⚙️ 安装教程 📚 使用教程

🌐 原始信息

原始名称	`better-notion-mcp`
Topics	`Notion集成MCP工具AI代理MarkdownClaude扩展`
GitHub	https://github.com/n24q02m/better-notion-mcp
License	MIT
语言	TypeScript

🔗 原始来源

🐙 GitHub 仓库 https://github.com/n24q02m/better-notion-mcp 🌐 官方网站 https://mcp.n24q02m.com/servers/better-notion-mcp/

收录时间：2026-05-24 · 更新时间：2026-05-24 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

Notion MCP服务器

Better Notion MCP

Features

Build from Source

Configuration

🤖 交给 Agent 安装 · Notion MCP服务器