mcpField
M
mcp-server-flomo MCP Server

mcp-server-flomo MCP Server

FeaturedLocal
mcp.soProductivity58Updated 82w ago
RepositoryVisit website

About mcp-server-flomo MCP Server

mcp-server-flomo is a TypeScript-based MCP server that writes text notes to Flomo. It suits users who want to save notes directly from an AI client.

Key features

  1. 01write_note tool for saving text notes
  2. 02TypeScript implementation with build and watch scripts
  3. 03Configurable through npx in Claude Desktop
  4. 04MCP Inspector debugging script included

Use cases

  1. 01Saving content from a Claude Desktop conversation as a Flomo note
  2. 02Recording ideas or summaries during AI chat sessions

MCP support

The server exposes a write_note tool over stdio to MCP clients, which passes note content to be written to Flomo.

#mcp#mcp-server#mcp-flomo#mcp-server-flomo

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "flomo": {
      "command": "npx",
      "args": [
        "-y",
        "@chatmcp/mcp-server-flomo"
      ],
      "env": {
        "FLOMO_API_URL": "<FLOMO_API_URL>"
      }
    }
  }
}
Run commandnpx -y @chatmcp/mcp-server-flomo
Environment variables to set
FLOMO_API_URL

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@chatmcp/mcp-server-flomo

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
contentstringYesText content of the note with markdown format

Details

From the project README

mcp-server-flomo MCP Server

write notes to Flomo.

This is a TypeScript-based MCP server help you write notes to Flomo.

preview

Features

Tools
  • write_note - Write text notes to Flomo
    • Takes content as required parameters

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-flomo": {
      "command": "npx",
      "args": ["-y", "@chatmcp/mcp-server-flomo"],
      "env": {
        "FLOMO_API_URL": "https://flomoapp.com/iwh/xxx/xxx/"
      }
    }
  }
}

Find Your Flomo_API_URL here

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.