mcp -flomo

This MCP server enables you to create Flomo notes directly from AI chat interactions. It translates natural language requests into Flomo API calls and submits properly formatted notes, so you can capture ideas, tasks, and reflections without breaking the flow of your conversation. The server is designed to work with AI chat tools like Claude, Cursor, Windsurf, Cline, and other MCP clients, allowing you to trigger note creation from your chats.

To use it, run the server with your Flomo API URL configured (FLOMO_API_URL). Once running, you can issue natural language commands such as asking the AI to publish or save a response as a Flomo note. The server handles converting the request into the appropriate Flomo API call, formatting the content, and submitting the note. For example, you can say: “How to publish a mcp server? Could you save the answer to flomo note after answering it,” and the server will save the content to your Flomo account. This enables seamless note-taking directly from your AI-assisted workflows.

Prerequisites:

• Node.js and npm installed on your system
• Access to the internet to fetch npm packages
• A Flomo API URL (FLOMO_API_URL) from your Flomo account

Step-by-step installation:

1. Ensure Node.js and npm are installed. You can verify with: node -v npm -v

2. Install the MCP server package using npx (no global install required): FLOMO_API_URL=your_api_url_here npx mcp-server-flomo

   If you prefer to install locally first, you can do: npm init -y npm install mcp-server-flomo FLOMO_API_URL=your_api_url_here npx mcp-server-flomo

3. Set the required environment variable for Flomo:

   • FLOMO_API_URL: Your Flomo API endpoint URL

4. (Optional) Persist configuration by creating an mcp configuration file as shown in the README example, then run the server via your preferred MCP host/client setup.

5. Verify the server starts and is ready to accept MCP requests from your chat tools.

Notes and tips:

• The FLOMO_API_URL environment variable is required for authenticating with Flomo and submitting notes.
• When using npx, the server runs on demand; consider a local install if you plan to run it frequently.
• The MCP integration relies on the MCP workflow, translating natural language into Flomo API calls and ensuring proper formatting before submission.
• If you encounter authentication or API errors, double-check your Flomo API URL and any required headers or tokens specified by Flomo's API settings.
• You can configure the server in an MCP host/client setup by following the example configuration in the README, including any additional environment variables your workflow may require.
• This server is designed to work with AI chat tools that support MCP, enabling automatic note creation from conversations.