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)

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