mcp-server-flomo MCP ServerFeatured

@chatmcp

About mcp-server-flomo MCP Server

Write notes to Flomo

#mcp #mcp-server #mcp-flomo #mcp-server-flomo

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

Write note to flomo

Overview

What is mcp-server-flomo?

It is a TypeScript-based MCP server that writes notes to the Flomo note‑taking platform. It integrates via Flomo’s incoming webhook API and is intended for users who want to send text notes to Flomo from any MCP‑enabled client, such as Claude Desktop.

How to use mcp-server-flomo?

Install dependencies with npm install and build with npm run build, or run directly with npx -y @chatmcp/mcp-server-flomo. Add the server configuration to your Claude Desktop config file (locations depend on your OS) and set the FLOMO_API_URL environment variable to your personal Flomo webhook URL. Use the write_note tool to send notes.

Key features of mcp-server-flomo

write_note tool that accepts content as the only required parameter
Uses Flomo’s incoming webhook for simple integration
Built with TypeScript for reliability
Works with any MCP‑compatible client
Runs via npx without global installation

Use cases of mcp-server-flomo

Save AI‑generated summaries or ideas directly to Flomo
Automate daily journal entries from a script or assistant
Capture quick notes from chat interfaces like Claude Desktop
Integrate Flomo into larger MCP‑based workflows

FAQ from mcp-server-flomo

What Flomo API URL do I need?

You need your personal Flomo webhook URL, which you can find at https://v.flomoapp.com/mine?source=incoming_webhook. It typically looks like https://flomoapp.com/iwh/xxx/xxx/.

How do I install and run the server?

Run npm install then npm run build, or use it directly with npx -y @chatmcp/mcp-server-flomo. For development, use npm run watch for auto‑rebuild.

Can I use this server with Claude Desktop?

Yes. Add the server configuration to your Claude Desktop config file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%/Claude/claude_desktop_config.json) as shown in the README.

What transport does the server use?

The server communicates over stdio, which is standard for MCP servers. Debugging can be done with the MCP Inspector by running npm run inspector.

How does authentication work?

Authentication is handled by the webhook URL itself — the URL contains a unique secret token. You set it as the FLOMO_API_URL environment variable; no additional credentials are required.

Frequently asked questions

What Flomo API URL do I need?

You need your personal Flomo webhook URL, which you can find at [https://v.flomoapp.com/mine?source=incoming_webhook](https://v.flomoapp.com/mine?source=incoming_webhook). It typically looks like `https://flomoapp.com/iwh/xxx/xxx/`.

How do I install and run the server?

Run `npm install` then `npm run build`, or use it directly with `npx -y @chatmcp/mcp-server-flomo`. For development, use `npm run watch` for auto‑rebuild.

Can I use this server with Claude Desktop?

Yes. Add the server configuration to your Claude Desktop config file (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%/Claude/claude_desktop_config.json`) as shown in the README.

What transport does the server use?

The server communicates over stdio, which is standard for MCP servers. Debugging can be done with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) by running `npm run inspector`.

How does authentication work?

Authentication is handled by the webhook URL itself — the URL contains a unique secret token. You set it as the `FLOMO_API_URL` environment variable; no additional credentials are required.