mcp -flomo

This MCP server integrates with Flomo and provides a single tool called write_note that lets you send text notes to Flomo. The server is designed to run via npx and loads the underlying package @chatmcp/mcp-server-flomo, exposing the write_note action as a readily accessible operation within your MCP workflow. To use it, configure Claude (or your MCP client) to connect to the mcp-server-flomo entry, and supply the required content parameter whenever you invoke write_note. The server relies on the FLOMO_API_URL environment variable to route notes into your Flomo inbox, so ensure that URL is correctly configured for your space.

Prerequisites:

• Node.js and npm installed on your system
• Access to run npm commands and install npm packages

Installation steps:

1. Install dependencies for the MCP server project (if you have a local clone): npm install

2. Build the server (for TypeScript project): npm run build

3. (Optional for development) Run in watch mode for auto-rebuilds: npm run watch

4. Run the MCP server using npx (as shown in the configuration): npx -y @chatmcp/mcp-server-flomo

5. If you’re integrating with Claude Desktop, add the server config to the appropriate JSON file as shown in the README, including the FLOMO_API_URL env value. Use the provided command and args to start the server via MCP routing.

Tips and considerations:

• The server uses stdio for communication; if you need to debug, consider using the MCP Inspector tool (npm run inspector) to access debugging URLs in your browser.
• Ensure FLOMO_API_URL is correctly set to the webhook URL provided by Flomo for your account.
• The mcpServers mapping uses the key mcp-server-flomo; you can adapt the name if you manage multiple MCP servers.
• If you encounter authentication or webhook issues, verify that the Flomo API URL is reachable from your network and that any necessary permissions are granted for the incoming webhook.
• When deploying, keep Node.js runtime consistent with your build (e.g., npm run build before starting in production).