Flomo
A TypeScript-based MCP server that enables users to write text notes directly to Flomo from Claude.
What is Flomo?
Flomo is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to typescript-based mcp server that enables users to write text notes directly to flomo from claude.
A TypeScript-based MCP server that enables users to write text notes directly to Flomo from Claude.
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A TypeScript-based MCP server that enables users to write te
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-server-flomoConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Flomo
MCP Server Flomo is a TypeScript-based MCP server that lets you capture notes directly into your Flomo account from within any MCP-compatible AI assistant such as Claude Desktop. It exposes a single write_note tool that accepts text content and posts it to Flomo via the app's incoming webhook API, so you can save ideas, summaries, or conversation highlights without switching apps or copying text manually. This makes it easy to build a frictionless note-capture habit alongside your AI workflows.
Prerequisites
- Node.js installed (for npx)
- A Flomo account at flomoapp.com
- A Flomo incoming webhook URL (obtained from https://v.flomoapp.com/mine?source=incoming_webhook)
- Claude Desktop or another MCP-compatible AI assistant client
Get your Flomo webhook URL
Log in to your Flomo account and navigate to the API/webhook settings page to generate your personal incoming webhook URL. Copy this URL — you will use it as the FLOMO_API_URL environment variable.
# Visit: https://v.flomoapp.com/mine?source=incoming_webhook
# Copy the webhook URL shown, e.g. https://flomoapp.com/iwh/xxx/xxx/Add the server to Claude Desktop configuration
Open your Claude Desktop configuration file and add the mcp-server-flomo entry with your webhook URL set as the FLOMO_API_URL environment variable.
# macOS config location:
# ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows config location:
# %APPDATA%\Claude\claude_desktop_config.jsonEdit the configuration file
Add the flomo MCP server block to the mcpServers section, replacing the placeholder URL with your actual Flomo webhook URL.
{
"mcpServers": {
"mcp-server-flomo": {
"command": "npx",
"args": ["-y", "@chatmcp/mcp-server-flomo"],
"env": {
"FLOMO_API_URL": "https://flomoapp.com/iwh/YOUR_ID/YOUR_TOKEN/"
}
}
}
}Restart Claude Desktop
Fully quit and reopen Claude Desktop to load the new MCP server configuration. The flomo server will connect automatically on startup.
Test the connection
Ask Claude to write a test note to Flomo. If the webhook URL is correct and the server is running, the note will appear in your Flomo account within seconds.
Flomo Examples
Client configuration
Complete claude_desktop_config.json entry for the Flomo MCP server using npx to run the @chatmcp/mcp-server-flomo package.
{
"mcpServers": {
"mcp-server-flomo": {
"command": "npx",
"args": ["-y", "@chatmcp/mcp-server-flomo"],
"env": {
"FLOMO_API_URL": "https://flomoapp.com/iwh/YOUR_USER_ID/YOUR_TOKEN/"
}
}
}
}Prompts to try
Use these prompts in Claude Desktop to save notes directly to Flomo during your conversations.
- "Save this to Flomo: the three key takeaways from our discussion about distributed systems"
- "Write a note to Flomo summarizing what we just figured out about the authentication bug"
- "Add this idea to my Flomo: use event sourcing for the order management service"
- "Save the following code snippet and explanation to Flomo for later reference"Troubleshooting Flomo
write_note returns an error or the note does not appear in Flomo
Double-check that FLOMO_API_URL is set to your exact personal webhook URL from https://v.flomoapp.com/mine?source=incoming_webhook. The URL is account-specific — do not share it or use a placeholder. Test the URL directly with curl: curl -X POST -H 'Content-Type: application/json' -d '{"content":"test"}' YOUR_URL
npx fails to install @chatmcp/mcp-server-flomo
Ensure your Node.js and npm versions are up to date. Try running 'npm install -g @chatmcp/mcp-server-flomo' first, then use the global binary path in your config instead of npx.
Claude Desktop does not show the flomo MCP server as connected
Verify the JSON syntax in your claude_desktop_config.json is valid (no trailing commas, correct nesting). Restart Claude Desktop completely. Check the Claude Desktop logs for MCP server startup errors.
Frequently Asked Questions about Flomo
What is Flomo?
Flomo is a Model Context Protocol (MCP) server that typescript-based mcp server that enables users to write text notes directly to flomo from claude. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Flomo?
Follow the installation instructions on the Flomo GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Flomo?
Flomo works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Flomo free to use?
Yes, Flomo is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Flomo Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Flomo? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Flomo in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Flomo?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.