Skip to main content
Glama
Jiraiya8

flomo-mcp-server

by Jiraiya8
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

flomo MCP Server

PyPI version License: MIT Python

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

什么是 MCP？

MCP (Model Context Protocol) 是 Anthropic 推出的开放协议，让 AI 模型能够与外部工具和服务进行交互。通过这个 server，你可以让 Claude 等AI 工具直接帮你记录想法到 flomo。

Related MCP server: MCP Server Flomo

功能

  • ✅ 向 flomo 添加笔记

  • ✅ 支持 Markdown 格式

  • ✅ 支持 #标签

  • ✅ 通过环境变量配置 API URL

  • ✅ 完善的错误处理

安装

使用 uvx（推荐，无需预安装）

uvx --from flomo-mcp-server flomo-mcp

使用 pip

pip install flomo-mcp-server
flomo-mcp

使用 uv

uv pip install flomo-mcp-server
flomo-mcp

配置

Claude Code

在 Claude Code 的 settings.json 中添加：

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

其他 MCP 客户端

同样配置 FLOMO_API_URL 环境变量即可使用。

获取 flomo API URL

  1. 登录 flomo 网页版

  2. 进入 设置 → API

  3. 复制你的专属 API URL

使用示例

在 Claude Code 中：

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

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

工具说明

add_flomo

向 flomo 添加一条笔记。

参数：

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

返回：

  • 成功: "已成功添加到 flomo"

  • 失败: 错误描述信息

API 限制

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

开发

# 克隆仓库
git clone https://github.com/Jiraiya8/flomo-mcp-server.git
cd flomo-mcp-server

# 安装开发依赖
uv sync

# 运行测试
uv run pytest tests/ -v

# 本地运行
FLOMO_API_URL="https://flomoapp.com/iwh/你的URL/" uv run flomo-mcp

Links

License

MIT License - 详见 LICENSE 文件

Available Tools

1 tool
add_flomoA

向 flomo 添加一条新的笔记/想法。支持 Markdown 格式，可在内容中使用 #标签

ParametersJSON Schema
NameRequiredDescriptionDefault
contentYes要记录的内容，支持 Markdown 格式，可在内容中使用 #标签

TDQS

A4.1/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries full burden. It mentions Markdown and #tags support, but does not disclose any side effects, idempotency, or potential errors. For a simple create tool, this is adequate but not thorough.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that efficiently conveys the purpose and key features with no wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (1 parameter, no output schema, no siblings), the description provides all necessary information: what it does and how it works (Markdown, tags). It is complete for an AI agent to use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% for the only parameter, and the tool description essentially repeats the same information. No additional meaning is added beyond what the schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action (add) and resource (new note/idea to flomo), with features like Markdown and #tags. Even without sibling tools, the verb-resource pairing is specific and unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The context is clear: this tool is for adding notes to flomo. No explicit when-to-use or when-not-to-use is needed given its simplicity, and no alternatives exist. A slight deduction for lacking any notes on prerequisites or limitations.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev0.1.1
    • First observedadd_flomo
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A3.8/5.0
Disambiguation5/5

With only one tool, there is no possibility of confusion between tools. The agent will always select the correct one.

Naming Consistency5/5

There is only one tool, so naming consistency is trivial. The tool uses a clear verb_noun pattern (add_flomo) which would be consistent if extended.

Tool Count1/5

A single tool for a note-taking service is far too few. Typical MCP servers for similar domains have at least 5-10 tools (CRUD, search, etc.). This feels incomplete.

Completeness1/5

The server only supports adding notes. Missing essential operations like listing, retrieving, updating, or deleting notes, making the surface severely incomplete for real use.

Maintenance

ActivityInactive
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • flomo-mcp

    hutusi
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables writing and managing notes to flomo via MCP. Provides tools for creating notes, resources for accessing them, and prompts for summarization.
    17
    -

  • Memos MCP Server

    kinmeic
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for creating, listing, updating, deleting memos, and managing attachments via the Memos API.
    18
    MIT

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/Jiraiya8/flomo-mcp-server'

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