Which integrations are available for this server?

Bridges Notion AI (e.g., Opus/Sonnet/Haiku models inside Notion) as an OpenAI-compatible chat backend, letting clients run Notion Agent inference and, via an internal MCP server, receive call_client_tool requests so client-local tools can be executed and the results fed back into the same Notion conversation. Supports large tool catalogs, account pooling, stream de-duplication/continuation, context trimming, and image attachment upload against Notion's internal endpoints.

How do I use notion-ai-mcp-tool-bridge?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@notion-ai-mcp-tool-bridge ask Notion AI to run my local tests and summarize the failures" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

notion-ai-mcp-tool-bridge

实验项目：让 Notion AI（Opus 5.5、Sonnet 5.5、Haiku 5.5 等）作为 OpenAI 兼容后端，并通过 MCP 回调执行客户端本地工具（Claude Code、Cowork、Codex 等）。

状态：已放弃（2026-10-16）。 工具往返能跑通，但多步任务里 Notion 经常在工具结果之后只思考、不回答，然后断流，根因没有确诊。完整的完成情况、卡点和继续研究的建议见 docs/NOTION_MCP_BRIDGE_POSTMORTEM.md。公开出来，希望有人能突破。

结论速览

项目	结果
Notion 原生调用本机工具（个人 MCP 回调）	跑通，本机随机标记往返验证
大工具目录（503 个函数、622 KB）	可用
CPA 下的 Chat / Responses 接口	可用
流式去重、截断补发、续传判定、失败报错	已修
Haiku 5.5 多步工具任务	多数能完成，但正文偶尔夹带假工具调用文本
Sonnet 5.5 / Opus 5.5 多步工具任务	大概率失败：工具结果回来后只思考不回答，约 60 秒后断流，同线程重试拿到空流
带工具时的速度	两步流程 6–18 秒，比直连慢很多
根因	未确诊，候选原因和建议实验见复盘第 5、8 节

复盘目录：目标与约束 → 最终架构 → 实验时间线（10-12 到 10-16） → 实现清单 → 最终卡点（含日志） → 放弃的路线 → 诊断方法 → 给后来者的复现步骤和"突破"判定标准 → 配置项。

Related MCP server: Notion Cowork Bridge

基于的上游项目

本仓库基于 maverickxone/notion2api（MIT License）修改而来。Notion 会话、账号池、流解析、模型注册、Web 前端等基础功能都来自上游，原 README 保留在 docs/UPSTREAM_README.md（English）。感谢上游作者。

本仓库新增或改动的部分：

文件	内容
`app/tool_bridge.py`	内置 MCP 服务器；把 Notion Agent 的 `call_client_tool` 转成标准 `tool_calls` 交给客户端，再把结果交回挂起的调用；续传、超时、空结束重试、失败报错
`app/tool_broker.py`	工具会话、请求 ID、调用 ID、Schema 校验、结果匹配
`app/stream_parser.py`	去掉 Notion 整段重发造成的重复；最终答案补发
`app/context_trimmer.py`	发送前裁剪历史
`app/image_uploader.py`	图片附件上传
`scripts/add_notion_account.py`	加账号 → 注册个人 MCP 连接 → 启用模块 → 进账号池
`scripts/mcp_tunnel_supervisor.py` 等	公网隧道守护、重连、探针
`tests/`	60 项离线测试，不访问 Notion
`docs/notion-mcp-bridge.md`	部署与配置说明

快速了解

客户端 --/v1/chat/completions(tools)--> 桥接 --runInferenceTranscript--> Notion Agent
Notion Agent --MCP(公网 HTTPS)--> 桥接 /notion-mcp/  (call_client_tool)
桥接 --tool_calls--> 客户端执行 --role=tool--> 桥接 --> Notion 同一轮继续回答

运行测试：

python -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python -m pytest tests -q

部署需要 Notion 账号的 token_v2、个人 space_view_id、一个公网 HTTPS 地址（Notion 从云端回调），细节见 docs/notion-mcp-bridge.md。不要提交 accounts.json、.env、data/。

免责声明

这是逆向接入 Notion 内部接口的研究代码，不是官方 API，可能随时失效，也可能违反 Notion 的服务条款。使用风险自负。

License

MIT，见 LICENSE。上游版权归 notion2api 作者所有。

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
nexusOAuth
com.civic
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Agent Orchestration Developer Tools App Automation
2
QuallaaOAuth
com.quallaa
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
AI & Machine Learning Communication
2
ToolRouter B
io.github.Humanleap
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Agent Orchestration Autonomous Agents
481

Related MCP Servers

notioncode_mcp
Coding Agents File Systems Shell Access
PandaNePanda
A
license
Not graded
quality
D
maintenance
Bridges Notion AI models to coding environments like OpenCode, Claude Code, and Codex CLI, enabling local file operations and shell commands via MCP tools.
Updated 3 months ago (2026-07-25 23:37 UTC)
20
MIT
Notion Cowork Bridge
File Systems Shell Access
soumosa
A
license
Not graded
quality
A
maintenance
Gives Notion Custom Agents real file tools and a real terminal over the Model Context Protocol, enabling them to read, edit, and run commands directly on the user's machine.
Updated 3 months ago (2026-07-29 23:43 UTC)
1
MIT
opencode-mcp-bridge
File Systems Shell Access Code Execution
nmt3325
A
license
Not graded
quality
B
maintenance
Enables MCP clients such as Notion AI to execute native OpenCode file, search, shell, web-fetch, and todo tools with job management and permission approvals.
Updated a month ago (2026-09-06 15:13 UTC)
17 npm
MIT
Rheo MCP Server
Speech Processing Text-to-Speech
MasterZ1311
A
license
Not graded
quality
B
maintenance
Enables AI agents to access local voice synthesis, zero-shot cloning, and voice catalog tools through native MCP tool calls for applications like Claude and Cursor.
Updated 10 days ago (2026-10-06 16:18 UTC)
2 npm
AGPL 3.0