mcp-server-flomo MCP Server

What is mcp-server-flomo?

mcp-server-flomo is a TypeScript-based MCP server that records text notes to the flomo note-taking service. It demonstrates core MCP concepts by providing resources, tools, and prompts for a simple notes system, intended for users who want to send notes to flomo via the Model Context Protocol.

How to use mcp-server-flomo?

Install dependencies with npm install, set the FLOMO_API_URL environment variable (copy .env.example to .env), and build with npm run build. Add the server configuration to your Claude Desktop config file (claude_desktop_config.json) pointing to the built index.js. Use the write_note tool to create notes, and the summarize_notes prompt for LLM summarization.

Key features of mcp-server-flomo

• Lists and accesses notes via note:// URIs with metadata
• Provides write_note tool to send content to the flomo API
• Includes summarize_notes prompt for generating summaries
• Built in TypeScript with auto-rebuild development support
• Debuggable via the MCP Inspector tool

Use cases of mcp-server-flomo

• Quickly record a thought or idea to flomo from an MCP-enabled client
• Automate note capture as part of a larger AI workflow
• Summarize existing notes stored in the server using the prompt

FAQ from mcp-server-flomo

What tools does mcp-server-flomo provide?

It provides one tool, write_note, which accepts a content parameter and sends the note content to the flomo API.

What environment variable is required?

The server requires FLOMO_API_URL to be set in the environment (or in .env) — this is your flomo API key URL.

How do I configure it for Claude Desktop?

Add a JSON entry to claude_desktop_config.json (located in ~/Library/Application Support/Claude/ on macOS or %APPDATA%/Claude/ on Windows) with the command pointing to the built server file.

How can I debug the server?

Use the npm run inspector command to launch the MCP Inspector, which provides a browser-based debugging interface for stdio communication.

What data does the server store?

The server stores notes in memory (not persisted) and sends them to flomo via the configured API. No local file storage is described.