mcp-server-flomo

在信息爆炸的时代，捕捉一闪而过的灵感、记录零散却重要的想法，是知识工作者的核心需求。Flomo（浮墨笔记）以其极简、轻量的设计理念，成为许多人记录碎片化思考的首选工具。但现在，记录的门槛被进一步降低——通过 mcp-server-flomo，你可以直接在 AI 对话中，用一句话将任何想法、摘要或对话内容写入你的 Flomo 笔记，真正实现“思考即记录”。

项目基本信息

一、项目介绍

mcp-server-flomo 是一个极度专注的模型上下文协议（MCP）服务器，它只做一件事：将文本笔记写入你的 Flomo 账户。

核心工具

该服务器仅暴露一个 MCP 工具：

• write_note：接受一个名为 content 的必需字符串参数，并将其作为一条新笔记写入 Flomo。

项目的设计哲学是“小而美”。它没有复杂的参数配置、没有多余的功能模块，仅通过 Flomo 官方提供的 API 接口，实现最纯粹的记录动作。这种极简设计使其极其可靠、易于理解，且几乎不出错。

二、核心优势

极致的专注与简洁

在功能日益膨胀的软件生态中，mcp-server-flomo 的单一职责设计令人耳目一新。它只有一个工具、一个参数，学习成本几乎为零。你不需要阅读冗长的文档，看一眼配置示例就能上手使用。

无缝的对话集成

它将“记笔记”这个动作无缝嵌入了 AI 对话流程。当你与 Claude 或其他 AI 助手讨论问题、产生灵感或获得有价值的结论时，无需跳出聊天界面，打开笔记应用，复制粘贴——只需说一句“帮我把这个想法记录到 Flomo”，即可完成。

开箱即用的配置

通过 npx 命令，你无需手动克隆仓库、安装依赖或构建项目。只需在 Claude Desktop 的配置文件中添加几行 JSON，填入你的 Flomo API 地址，即可立即使用。

MIT 开源协议

项目采用 MIT 协议，意味着你可以自由使用、修改和分发，无论是个人项目还是商业产品，都没有法律障碍。

三、适用场景

灵感与想法捕获

当你与 AI 头脑风暴时，任何迸发的创意都可以被瞬间记录：“帮我记下这个点子：用 MCP 协议为所有笔记工具建立统一接口。”

对话内容归档

与 AI 完成一轮深入讨论后，你可以将结论或重要信息直接保存到 Flomo：“把我们刚才讨论的项目架构方案整理成要点，写入 Flomo。”

阅读与学习笔记

当你让 AI 帮你阅读文章、论文或新闻时，可以同步生成笔记：“总结这篇文章的核心观点，并添加到我的 Flomo 中。”

自动化工作流节点

开发者可以将此 MCP 服务器作为自动化流程中的一环。例如，结合定时任务，让 AI 每天生成一条“今日金句”并自动写入 Flomo；或者将 RSS 阅读器的摘要自动推送到笔记中。

四、安装教程

环境要求

获取 Flomo API URL

1. 登录你的 Flomo 账户（网页版或 App）。
2. 进入 设置 -> API 页面。
3. 复制你的专属 API 链接，格式通常为：https://flomoapp.com/iwh/xxxxxxxx/xxxxxxxx/。
   注意：请妥善保管该链接，不要分享给他人，拥有此链接即可直接向你的 Flomo 写入内容。

在 Claude Desktop 中配置

编辑 Claude Desktop 的配置文件，位置如下：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置，将 FLOMO_API_URL 的值替换为你自己的 API 链接：

{
  "mcpServers": {
    "mcp-server-flomo": {
      "command": "npx",
      "args": ["-y", "@chatmcp/mcp-server-flomo"],
      "env": {
        "FLOMO_API_URL": "https://flomoapp.com/iwh/xxxxxxxx/xxxxxxxx/"
      }
    }
  }
}

保存文件后，完全退出并重启 Claude Desktop，配置即生效。

五、使用示例

配置完成后，你可以在 Claude Desktop 中用自然语言指挥 AI 完成笔记写入。

示例一：记录灵感

用户：我突然想到一个关于产品设计的好点子：用 AI 分析用户的笔记习惯，自动推荐标签。帮我把这个记到 Flomo。

AI 的操作与回复:
AI 会调用 write_note 工具，传入内容 "用 AI 分析用户的笔记习惯，自动推荐标签"。稍后，你打开 Flomo，就能看到这条新笔记。

示例二：保存对话总结

用户：把我们刚才关于 MCP 服务器的讨论总结一下，写到 Flomo 里。

AI 的操作与回复:
AI 会先回顾对话内容，生成一段总结，然后调用 write_note 工具将其写入 Flomo。总结内容可能是：“MCP 服务器是连接 AI 与外部工具的桥梁。我们讨论了浏览器自动化、语音合成和笔记记录三种类型的 MCP 服务器，它们分别解决了...”

示例三：阅读辅助笔记

用户：看一下这篇关于量子计算的文章 https://example.com/quantum-computing-101，把核心概念提炼出来，记到我的 Flomo。

AI 的操作与回复:
AI 会使用网页抓取工具（如 MCP Fetch Server）获取文章内容，进行分析和总结，然后调用 write_note 将摘要写入 Flomo。

六、常见问题

问：配置后，Claude 提示找不到 write_note 工具怎么办？

答：请按以下步骤排查：

1. 检查配置文件：确保 JSON 格式正确，特别是 FLOMO_API_URL 的值是否已填写，且被引号包围。
2. 检查网络连接：npx 首次运行时需从 npm 下载 @chatmcp/mcp-server-flomo 包，请确保网络通畅。
3. 检查 API URL 有效性：你可以在浏览器中访问该 API URL，若能看到 Flomo 的成功提示页面，说明链接有效。
4. 查看 Claude 控制台日志：Claude Desktop 通常会输出 MCP 服务器的连接错误信息，那里会有更详细的提示。

问：我可以写入多条笔记吗？每天有数量限制吗？

答：该服务器本身没有限制，它只是调用 Flomo 的 API。实际限制取决于 Flomo 官方对 API 的调用频率限制。作为轻度使用，通常不会触及限制。如果你需要批量导入大量笔记，建议使用 Flomo 官方支持的批量导入方式。

问：能不能给笔记添加标签？

答：可以，但不是通过单独的参数。Flomo 支持在笔记内容中使用 #标签 格式。你可以在让 AI 写入的内容中包含 #标签名，例如：“这是一条关于 AI 的笔记 #人工智能 #MCP”，Flomo 会自动识别并添加标签。

问：我的 Flomo API URL 需要保密吗？

答：需要。该 URL 相当于一个“写入权限密钥”，任何人得到它都可以向你的 Flomo 账户写入笔记。请勿将其上传到公开的代码仓库或分享给不信任的人。如果不慎泄露，可以到 Flomo 的 API 设置页面重新生成新的链接。

七、总结

mcp-server-flomo 是 MCP 生态中“小而美”工具的典范。它践行了 Unix 哲学——“做好一件事”，将“写入 Flomo 笔记”这个动作做到了极致的简单和可靠。它没有复杂的功能堆砌，却精准解决了 AI 对话与知识记录之间的“最后一公里”问题。

对于 Flomo 用户而言，这个工具能让你与 AI 的每一次有价值的对话，都自然而然地在你的笔记中沉淀下来，让灵感不再流失。对于开发者而言，它也是学习如何构建一个简洁、实用的 MCP 服务器的优秀参考范例。只需花一分钟完成配置，你便能体验到“说一句，就记下”的流畅感。