MCP Server Flomo Go

🚀 Flomo Command Line Toolset

This is a collection of Flomo tools developed in Go language, which supports sending notes to Flomo through both the command-line tool and the MCP server.

✨ Features

• 📝 Support for quickly creating notes via the command line.
• 🏷️ Ability to add tags to notes.
• 🔌 Integration with the MCP server.
• 📊 Detailed logging functionality.
• 🌈 User-friendly command-line interface design.

📦 Installation

1. Clone the code repository:

git clone https://github.com/yourusername/mcp-server-flomo-go.git
cd mcp-server-flomo-go

2. Configure environment variables:

cp .env.example .env

Edit the .env file and add your Flomo API URL:

FLOMO_API_URL=https://flomoapp.com/iwh/xxx/xxx

3. Compile the CLI tool:

go build -o mcp-server-flomo-go cmd/flomo/main.go

💻 Usage Examples

Command-line Tool

Basic Usage

./flomo -c "Your note content"

Adding Tags

./flomo -c "Note content" -t "Tag1,Tag2"

Reading Content from Standard Input

echo "Note content" | ./flomo

Displaying Detailed Information

./flomo -c "Note content" -v

Command-line Argument Explanation

• -c, --content: Required. Sets the note content.
• -t, --tags: Optional. Sets the list of tags (separated by commas).
• -v, --verbose: Optional. Displays detailed log information.
• -h, --help: Displays help information.

MCP Server

Starting the Server

go run server.go

Available Tool Commands

• write_note: Writes note content.
  • Parameter: content (string) - Note content supporting Markdown format.

📚 Documentation

Project Structure

.
├── cmd
│   └── flomo
│       └── main.go    # Implementation file for the command-line tool
├── pkg
│   └── flomo
│       └── client.go  # Implementation file for the Flomo API client
├── server.go          # Implementation file for the MCP server
├── .env              # Environment variable configuration file
└── README.md         # This guide document

Development Specifications

1. Follow the Go language code specifications and standard library style.
2. Use go fmt to format the code.
3. Ensure that all log information is clear and easy to read.

Example Output

Note sent successfully! 🎉
Creation time: 2025-04-16 00:35:06
Tags: Test
View link: https://v.flomoapp.com/mine/?memo_id=xxx

Detailed information:
- Source: incoming_webhook
- Creator ID: xxx
- Response status code: 0
- Response message: Recorded
- Total time taken: 896.754667ms

Important Notes

⚠️ Important Note

Please keep your Flomo API URL safe and avoid sharing it with others.

💡 Usage Tip

It is recommended to control the frequency when sending a large number of notes. If you encounter any issues, use the -v parameter to view detailed log information.

📄 License

This project is licensed under the MIT License.