Mochi MCP Server

A Model Context Protocol server that enables AI agents (Claude, Codex, etc.) to manage your Mochi.cards flashcards.

Features

• Browse decks and cards

• Search cards by content or tags

• Create/Update cards with two-phase commit (preview before applying)

• Delete cards with typed confirmation (safety first)

• Robust safety - deck deletion disabled by default

Quick Start

# Install
npm install

# Build
npm run build

# Run (needs your Mochi API key)
MOCHI_API_KEY=your_key_here node dist/index.js

Get your API key from the Mochi app: Settings → Account → API Key.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mochi": {
      "command": "node",
      "args": ["/path/to/mochi-mcp/dist/index.js"],
      "env": {
        "MOCHI_API_KEY": "your_api_key"
      }
    }
  }
}

Then ask Claude: "List my Mochi decks" or "Search for cards about gradients".

Tools

Read Operations

Write Operations (Two-Phase Commit)

Tag Operations (Two-Phase)

Delete Operations (Requires Confirmation)

Performance Notes

• Global search scans at most 1000 cards

• Per-deck search scans at most 5000 cards

• Use list_cards_page with pagination for larger collections

• Date filters use UTC (ISO 8601 format: YYYY-MM-DDTHH:mm:ss.sssZ)

Configuration

Safety Design

1. Two-phase commit: Create/update operations show a preview first. You approve by using the returned token.

2. Typed confirmations: Delete requires typing "delete card <id>" exactly.

3. Deck deletion disabled: Must set MOCHI_ALLOW_DECK_DELETE=true to enable.

4. Soft delete default: Cards go to trash (recoverable in Mochi app).

Development

# Run tests
npm test

# Type check
npm run lint

# Development mode
MOCHI_API_KEY=your_key npm run dev

# Test with MCP Inspector
npm run inspect

License

MIT