Flomo MCP Server logo

Flomo MCP Server

by xianminx

Flomo MCP Server allows you to create notes in Flomo directly through AI chat interactions in Cursor or Claude desktop. It enables seamless writing and organization of thoughts through natural language commands.

View on GitHub

Last updated: N/A

Flomo MCP Server

NPM Version

NPM Version

MIT licensed

MIT licensed

smithery badge

smithery badge

https://github.com/xianminx/mcp-server-flomo

A Model Context Protocol (MCP) server that lets you create notes in Flomo directly through AI chat interactions in Cursor or Claude desktop. Write and organize your thoughts seamlessly through natural language commands.

Usage

Installing via Smithery

To install mcp-server-flomo for Claude Desktop automatically via Smithery:

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

mcp-get

mcp-get: mcp-server-flomo

mcp-get: mcp-server-flomo

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

mcp.so

https://mcp.so/protocol/mcp-server-flomo/wss://mcp.smithery.ai:443

Manually configure

Configure Claude / Cursor / Windsurf / Cline / ChatWise / Cherry Studio etc.

FLOMO_API_URL=your_api_url_here npx mcp-server-flomo

Or configure for your MCP Host / Client. See https://mcp.so/protocol/mcp-server-flomo/wss://mcp.smithery.ai:443 for configuration detail.

Get your Flomo API URL from Flomo API Settings

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

Once the server is running, you can create notes in Flomo through natural language commands in your AI chat. Here are some examples:

"How to publish a mcp server? Could you save the answer to flomo note after answering it"

This will save the Cursor AI Agent response to Flomo directly in the chat conversation!

<img src="https://raw.githubusercontent.com/xianminx/mcp-server-flomo/refs/heads/main/public/images/mcp-cursor-flomo.png" width="400">

The server will handle:

  • Converting your natural language requests into Flomo API calls
  • Proper formatting and submission of your notes
  • Providing feedback on successful note creation

Dev

  1. Get your Flomo API URL from Flomo API Settings

  2. Install and configure:

    # Install dependencies
    npm install
    FLOMO_API_URL=your_api_url_here npx .
    

Technical Details

  • Built with TypeScript and the Model Context Protocol SDK
  • Communicates with Flomo via their REST API
  • Runs over stdio for seamless integration with AI tools

License

This project is licensed under the MIT License—see the LICENSE file for details.