mcp -maimemo

The Maimemo MCP Server bridges the Maimo Memo (Maimemo) API with MCP clients. It exposes MCP endpoints for interacting with Maimemo data such as interpretations, notes, notepads, phrases, and vocabularies, enabling applications to query and manage content programmatically through the MCP protocol. To use it, you must obtain a token from the Maimemo app (under My > More settings > Experimental features > Open API) and supply it to the server via the MAIMEMO_TOKEN environment variable. Once running, MCP clients can perform actions like listing and retrieving vocabularies, notes, notepads, phrases, and interpretations using the corresponding MCP commands (e.g., list_interpretations, get_vocabulary, list_notepads, etc.). Integrating the server into an MCP-enabled app typically involves configuring the MCP client to connect to the running server named mcp-server-maimemo and passing the MAIMEMO_TOKEN for authentication.

Prerequisites:

• Go installed (Go 1.20+ recommended)
• Internet access to fetch the module

Installation steps:

1. Ensure Go is installed. Verify with: go version

2. Install the MCP server binary from GitHub: go install github.com/A11Might/mcp-server-maimemo@latest

3. Run the server (example with token): export MAIMEMO_TOKEN=your_maimemo_token mcp-server-maimemo

4. Alternatively, configure via MCP config: Create or modify your MCP config to include: { "mcpServers": { "mcp-server-maimemo": { "command": "mcp-server-maimemo", "env": { "MAIMEMO_TOKEN": "your_maimemo_token" }, "args": [] } } }

5. Ensure the token is kept secret and not checked into source control.

Notes and tips:

• The MAIMEMO_TOKEN is required for authentication with the Maimemo API; obtain it from the Maimemo app as described in the README.
• The server exposes endpoints for Interpretations, Notes, Notepads, Phrases, and Vocabularies. Use the corresponding MCP commands as documented in your MCP client to perform actions like list, get, create, update, and delete where supported.
• Keep your MAIMEMO_TOKEN secure. Rotate tokens if you suspect exposure.
• If you encounter connection issues, verify network access to Maimemo APIs and confirm the token is valid.
• This project uses Go; ensure you compile/run on a compatible environment and keep the binary up to date with the latest release.