mcp-server-flomo MCP Server

mcp-server-flomo MCP Server

By jamesfeng2009 GitHub

-

Overview

What is mcp-server-flomo?

The mcp-server-flomo is a TypeScript-based MCP server designed to implement a simple notes system that allows users to record and manage notes effectively.

How to use mcp-server-flomo?

To use mcp-server-flomo, install the necessary dependencies, build the server, and configure it with Claude Desktop. You can create new notes and generate summaries of existing notes through its API.

Key features of mcp-server-flomo?

  • Resources representing text notes with URIs and metadata.
  • Tools for creating new notes via the write_note command.
  • Prompts for generating summaries of notes using the summarize_notes command.

Use cases of mcp-server-flomo?

  1. Recording and managing personal notes.
  2. Generating summaries for quick reference.
  3. Integrating with other applications for note-taking functionalities.

FAQ from mcp-server-flomo?

  • How do I install mcp-server-flomo?

You can install it by running npm install in the project directory.

  • Can I use mcp-server-flomo on Windows?

Yes! You can configure it on Windows by adding the server config to the appropriate Claude Desktop configuration file.

  • What is the purpose of the MCP Inspector?

The MCP Inspector helps in debugging by providing a URL to access debugging tools in your browser.

Content

mcp-server-flomo MCP Server

record notes to flomo

This is a TypeScript-based MCP server that implements a simple notes system. It demonstrates core MCP concepts by providing:

  • Resources representing text notes with URIs and metadata
  • Tools for creating new notes
  • Prompts for generating summaries of notes

Features

Resources

  • List and access notes via note:// URIs
  • Each note has a title, content and metadata
  • Plain text mime type for simple content access

Tools

  • write_note - Create new text notes
    • Takes content as required parameter
    • Sends the note content to flomo API

Prompts

  • summarize_notes - Generate a summary of all stored notes
    • Includes all note contents as embedded resources
    • Returns structured prompt for LLM summarization

Development

Install dependencies:

npm install

Configure environment variables:

  1. Copy .env.example to .env
  2. Update FLOMO_API_URL in .env with your Flomo API key

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": "/path/to/mcp-server-flomo/build/index.js"
    }
  }
}

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.

mcp-server-flomo

No tools information available.
No content found.