MCP Server for Flomo

What is MCP Server for Flomo?

MCP Server for Flomo is a Web server and CLI tool built on the Model Context Protocol (MCP) that interacts with the Flomo API, allowing users to add notes to Flomo from different environments.

How to use MCP Server for Flomo?

Install via pip install mcp-server-flomo, create a .env file with your FLOMO_API_URL, then use the flomo-cli command (e.g., flomo-cli write "note") or start the web server with flomo-server (default port 12345) and send POST requests to /write_note.

Key Features of MCP Server for Flomo

• Provides a command-line tool (flomo-cli) for quick note writing.
• Web server mode with REST endpoints (GET /, GET /test, POST /write_note).
• Supports Markdown formatting in notes.
• Configurable via .env file containing the Flomo API URL.
• Test connection function to verify Flomo API access.

Use cases of MCP Server for Flomo

• Adding notes to Flomo directly from the command line.
• Integrating Flomo note creation into scripts or automated workflows.
• Running a local API server to accept notes from other applications.
• Automating note capture from file contents using the -f flag.

FAQ from MCP Server for Flomo

How do I configure the Flomo API URL?

Create a .env file in the project root with FLOMO_API_URL=https://flomoapp.com/iwh/yourID/yourAPIkey/. The URL is obtained from Flomo's Settings > API page.

How do I install MCP Server for Flomo?

Install from PyPI: pip install mcp-server-flomo. Optionally install development dependencies with pip install mcp-server-flomo[dev].

What endpoints does the web server provide?

The server runs on HTTP (default port 12345) and provides GET / (usage instructions), GET /test (test connection), and POST /write_note (write a note to Flomo).

What could prevent the server from starting?

Check if port 12345 is already occupied. Also verify that the FLOMO_API_URL in .env is correct and that the Flomo API is reachable.

Is there a way to test the Flomo connection?

Yes, run flomo-cli test to test the connection to the Flomo API using your configured URL.