mochi-mcp

MCP server for the Mochi Cards API. Enables AI assistants to manage flashcards, decks, and templates through the Model Context Protocol.

Features

Cards

• list_cards - List cards with optional filtering by deck

• get_card - Retrieve a single card by ID

• create_card - Create a new flashcard

• update_card - Update an existing card

• delete_card - Permanently delete a card

• add_attachment - Upload file attachments to cards

• delete_attachment - Remove attachments from cards

Decks

• list_decks - List all decks

• get_deck - Retrieve a single deck by ID

• create_deck - Create a new deck

• update_deck - Update deck properties

• delete_deck - Permanently delete a deck

Templates

• list_templates - List all templates

• get_template - Retrieve a template by ID

• create_template - Create a new card template

Due Cards

• get_due_cards - Get cards due for review (spaced repetition)

Related MCP server: Anki MCP Server

Installation

bun install

Configuration

This server requires a Mochi API key. To get your API key:

1. Open the Mochi Cards app

2. Go to Account Settings

3. Copy your API key

Set the MOCHI_API_KEY environment variable when running the server.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "mochi": {
      "command": "bun",
      "args": ["run", "/path/to/mochi-mcp/src/index.ts"],
      "env": {
        "MOCHI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace /path/to/mochi-mcp with the actual path to this repository.

Development

# Run with hot reload
bun run dev

# Run once
bun run start

License

MIT