mcp-mochi

Model Context Protocol (MCP) server for Mochi flashcards. This is a fork of fredrikalindh/mcp-mochi v2.6.0 with full Mochi API coverage (20 tools), faithful response schemas and automatic retry on Mochi's per-account concurrency limiter.

Features

• Create, update, archive and delete flashcards
• Create cards from templates with automatic field name-to-ID mapping
• Fetch a single flashcard or deck by ID
• Full deck CRUD (create, get, update, archive, delete)
• Create new templates
• Add or remove attachments (images, audio) on any card
• Get cards due for review on a given date
• List flashcards, decks and templates
• Automatic retry on Mochi's per-account concurrency limiter (HTTP 429)

Usage with Claude Desktop

Add the following to your claude_desktop_config.json. Your MOCHI_API_KEY is in Mochi under Settings → Account → Subscription → API Keys.

NPX (recommended)

{
  "mcpServers": {
    "mochi": {
      "command": "npx",
      "args": ["-y", "@k-and/mcp-mochi"],
      "env": {
        "MOCHI_API_KEY": "<YOUR_TOKEN>"
      }
    }
  }
}

Local Development

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

Local Development Setup

1. Clone and install dependencies:

   git clone https://github.com/k-and/mcp-mochi.git
   cd mcp-mochi
   npm install

2. Build the project:

   npm run build

3. Test with MCP Inspector:

   MOCHI_API_KEY=<YOUR_TOKEN> npx @modelcontextprotocol/inspector node dist/index.js

Available Tools

Flashcards

Tool	Description
create_flashcard	Create a new flashcard in Mochi
create_card_from_template	Create a flashcard using a template with field names (auto-maps to IDs)
get_flashcard	Fetch a single flashcard by ID
list_flashcards	List flashcards, optionally filtered by deck
search_flashcards	Find flashcards by substring match against content, name or tags (client-side)
update_flashcard	Update a flashcard's content, deck, template, fields, position or trash state
archive_flashcard	Archive or unarchive a flashcard
delete_flashcard	Permanently delete a flashcard and its attachments
get_due_cards	Get flashcards due for review on a given date

Decks

Tool	Description
create_deck	Create a new deck, optionally nested under a parent
get_deck	Fetch a single deck by ID
list_decks	List all decks
update_deck	Update a deck's name, parent, sort order, archive or trash state, or display options
archive_deck	Archive or unarchive a deck
delete_deck	Permanently delete a deck (contained cards and child decks are not cascaded)

Templates

Tool	Description
create_template	Create a new template for cards
get_template	Get a single template by ID
list_templates	List all templates with their field definitions

Attachments

Tool	Description
add_attachment	Attach a file (image, audio, etc.) to an existing card
delete_attachment	Remove an attachment from a card by filename

Resources

URI	Description
mochi://decks	List of all decks
mochi://templates	List of all templates

Prompts

Prompt	Description
write-flashcard	Generates a well-structured flashcard following best practices (atomic questions, cloze deletions, etc.)

Examples

Create a simple flashcard

{
  "tool": "create_flashcard",
  "params": {
    "content": "What is MCP?\n---\nModel Context Protocol, a protocol for providing context to LLMs",
    "deckId": "<DECK_ID>"
  }
}

Create a card from template

{
  "tool": "create_card_from_template",
  "params": {
    "templateId": "<TEMPLATE_ID>",
    "deckId": "<DECK_ID>",
    "fields": {
      "Front": "What is the capital of France?",
      "Back": "Paris"
    }
  }
}

Get today's due cards

{
  "tool": "get_due_cards",
  "params": {}
}

Create a deck

{
  "tool": "create_deck",
  "params": {
    "name": "Linear Algebra",
    "parentId": "<PARENT_DECK_ID>"
  }
}