mcp-server-flomo MCP Server

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.