Flomo Mcp Server Demo

by SheldonFat

246 downloads
Not rated
GitHub

Description

# 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…

About

# 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 ##…

Details

Author
SheldonFat
Downloads
246
Categories
Other

- Resources exposed via note:// URIs with title, content, and metadata.
- Tool create_note to create new text notes with title and content.
- Prompt summarize_notes to generate a summary of all stored notes.
- Plain text MIME type for simple content access.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Flomo Mcp Server Demo
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with npm install, build with npm run build, then add the server config to Claude Desktop’s configuration file (path varies by OS). For debugging, use the MCP Inspector via npm run inspector.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "flomo mcp server demo": {
            "flomo-mcp": {
                "command": "npx",
                "args": [
                    "-y",
                    "@panghui8383/flomo-mcp@0.0.5"
                ],
                "env": {
                    "FLOMO_API_URL": "https://flomoapp.com/iwh/xxxx/xxxxx/"
                }
            }
        }
    }
}

McpServers

{
    "flomo-mcp": {
        "command": "npx",
        "args": [
            "-y",
            "@panghui8383/flomo-mcp@0.0.5"
        ],
        "env": {
            "FLOMO_API_URL": "https://flomoapp.com/iwh/xxxx/xxxxx/"
        }
    }
}

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.