flomo-mcp-server 0.1.0

MCP server for flomo - 快速记录想法到 flomo

flomo MCP Server

MCP server for flomo - 让 AI 工具（如 Claude Code）能够快速向 flomo 添加笔记。

安装

使用 pip

pip install flomo-mcp-server

使用 uv（推荐）

uv pip install flomo-mcp-server

或者从源码安装：

uv sync

配置

Claude Code

方式 1: 已安装后运行

{
  "mcpServers": {
    "flomo": {
      "command": "flomo-mcp",
      "args": [],
      "env": {
        "FLOMO_API_URL": "https://flomoapp.com/iwh/你的专属URL/"
      }
    }
  }
}

方式 2: 使用 uv run（无需预安装）

{
  "mcpServers": {
    "flomo": {
      "command": "uv",
      "args": ["run", "flomo-mcp"],
      "env": {
        "FLOMO_API_URL": "https://flomoapp.com/iwh/你的专属URL/"
      }
    }
  }
}

注意：使用 uv run 方式需要先克隆仓库并进入目录，或指定完整路径。

获取 API URL

1. 登录 flomo 网页版 (https://flomoapp.com)
2. 进入设置 -> API
3. 复制你的专属 API URL

使用示例

在 Claude Code 中：

"帮我记录一条 flomo：今天学到了 MCP 协议的基本原理 #学习"

Claude 会调用 add_flomo 工具，将内容添加到你的 flomo。

工具说明

add_flomo

向 flomo 添加一条笔记。

参数：

• content (必填): 要记录的内容，支持 Markdown 格式，可使用 #标签

返回：

• 成功: "已成功添加到 flomo"
• 失败: 错误描述信息

API 限制

通过 API 每天最多发布 100 条，此限制由 flomo API 自动处理。

开发

使用 pip

安装开发依赖：

pip install -e ".[dev]"

运行测试：

pytest tests/ -v

使用 uv（推荐）

安装开发依赖：

uv sync

运行测试：

uv run pytest tests/ -v

License

MIT