Flomo

This MCP server lets you create Flomo notes directly from AI chat interactions. By turning natural language requests into Flomo API calls, you can write and organize your thoughts without leaving your chat tool.

How to use

You connect this server to an MCP client (such as Claude, Cursor, Windsurf, or others) to publish notes to Flomo from your conversations. Ask questions or give natural language commands like saving a response as a Flomo note, and the server handles formatting, submission, and confirmation of success.

How to install

Prerequisites you need on your machine before 설치ing the MCP server are Node.js and npm (or npm-compatible tooling). Ensure you can run npm or npx from your terminal.

Option A: Install via Smithery for Claude Desktop automatically via the client you use.

npx -y @smithery/cli install mcp-server-flomo --client claude

Option B: Use the MCP-get helper to install the server locally.

npx @michaellatman/mcp-get@latest install mcp-server-flomo

Option C: Manually configure and run the server with your Flomo API URL.

First obtain your Flomo API URL from Flomo API Settings, then run the server with that URL.

FLOMO_API_URL=your_api_url_here npx mcp-server-flomo

If you prefer a JSON configuration snippet for your MCP host, you can place the following in your MCP config to run the server.

{
  "mcpServers": {
    "mcp-server-flomo": {
      "command": "npx",
      "args": [
        "mcp-server-flomo"
      ],
      "env": {
        "FLOMO_API_URL": "your_api_url_here"
      }
    }
  }
}

Additional usage details

Once running, you can begin sending natural language commands in your AI chat to create Flomo notes. The server converts your requests into API calls to Flomo, formats the note content, submits it, and reports back on success.

The server can be reached through the MCP protocol URL shown in your setup documentation. For reference, the MCP protocol URL is available in protocol references like wss://mcp.smithery.ai:443.

Dev notes and workflow

From a development perspective, you build with TypeScript and the MCP SDK. The server communicates with Flomo through Flomo’s REST API and runs via stdio for integration with AI tools.

Available tools

nl_to_flomo_api

Converts natural language requests into Flomo REST API calls to create and format notes.

note_formatter

Formats note content for submission to Flomo and ensures proper metadata is included.

submission_feedback

Provides feedback on successful creation of a Flomo note and confirms status in the chat.