Mochi

You can run a Mochi Cards MCP server to manage flashcards with AI assistance. It supports hosting over HTTP/SSE for cloud deployments and a local stdio transport for use with Claude Desktop, giving you flexible options to create, organize, and review cards and decks with automation.

How to use

Connect to the MCP server using your preferred client either over HTTP/SSE or via the stdio transport for local use with Claude Desktop. You can create and manage cards, decks, and templates, retrieve cards due for review, and attach files to cards. Card content is written in Markdown and you structure front and back with a clear separator to keep questions and answers distinct.

How to install

Prerequisites: ensure you have Node.js installed on your system.

# Install dependencies
npm install

# Start the development server for local usage
npm run dev

# Build the project for distribution
npm run build

# Build the stdio version for Claude Desktop usage
npm run build:stdio

Additional setup and usage notes

Deployment options are available for both remote hosting and local usage. For remote hosting, you typically deploy to a hosting platform that runs the MCP server and exposes an API endpoint. For local usage, you run a build that outputs a stdio transport compatible with Claude Desktop.

Environment setup includes providing your API key for Mochi Cards. You use this key when configuring the client and when running the local stdio transport.

Usage highlights include creating and listing cards and decks, editing their details, adding attachments, and reviewing due cards. Card content uses Markdown format with a front side and a back side separated by a delimiter.

Examples and formats

Card content example in Markdown format. Use --- to separate the front (question) from the back (answer).

What is the capital of France?
---
Paris

Bulk card creation

You can create multiple cards in a single operation by providing a deck identifier and an array of cards with their content and optional tags.

{
  "deck_id": "deck-id",
  "cards": [
    { "content": "Question 1\n---\nAnswer 1" },
    { "content": "Question 2\n---\nAnswer 2", "tags": ["tag1", "tag2"] }
  ]
}

Available tools

create_card

Create a new card in a deck with Markdown content for front and back.

get_card

Retrieve details for a specific card by its identifier.

list_cards

List all cards in a deck or across decks according to filters.

update_card

Update an existing card's content, tags, or metadata.

delete_card

Remove a card from a deck.

add_attachment

Attach a file or resource to a card.

delete_attachment

Remove an attachment from a card.

create_cards_bulk

Create multiple cards in a single operation.

create_deck

Create a new deck to organize cards.

get_deck

Retrieve details for a specific deck.

list_decks

List all decks.

update_deck

Update deck details, such as name or metadata.

delete_deck

Delete a deck (cannot be undone).

create_template

Create a new card template for consistent card formatting.

get_template

Retrieve details for a template.

list_templates

List all templates.

get_due_cards

Fetch cards due for review.