mcpField
F
Flomo Mcp Server Demo

Flomo Mcp Server Demo

Local
github.com/SheldonFatProductivity0Updated 55w ago
Repository

About Flomo Mcp Server Demo

Flomo Mcp Server Demo is a TypeScript MCP server for storing and accessing text notes. It exposes notes as resources, provides a tool to create them, and a prompt for summarizing stored notes.

Key features

  1. 01Access notes through note:// URIs
  2. 02Create notes with title and content
  3. 03Generate a summary prompt from stored notes
  4. 04Attach note metadata and plain-text content

Use cases

  1. 01Store short text notes for MCP clients
  2. 02Let an LLM summarize all stored notes

MCP support

The MCP server exposes note resources, a note-creation tool, and a summarization prompt to MCP clients.

#flomo#mcp#notes#typescript

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-mcp-sheldonfat": {
      "command": "npx",
      "args": [
        "-y",
        "@panghui8383/flomo-mcp"
      ],
      "env": {
        "FLOMO_API_URL": "<FLOMO_API_URL>"
      }
    }
  }
}
Run commandnpx -y @panghui8383/flomo-mcp
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@panghui8383/flomo-mcp

Tools

1

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
contentstringYesText content of the note with Markdown formatting

Details

From the project README

flomo-mcp MCP Server

A Model Context Protocol server

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
  • create_note - Create new text notes
    • Takes title and content as required parameters
    • Stores note in server state
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

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": {
    "flomo-mcp": {
      "command": "/path/to/flomo-mcp/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.

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.