@louis030195/mochi-mcp

MCP (Model Context Protocol) server for Mochi flashcard integration. Create, manage, and review spaced repetition flashcards directly from Claude, ChatGPT, or any LLM that supports MCP.

---

<div align="center">

💖 Support This Project

If you find this MCP server useful, please consider supporting its development!

👉 Click here to support this project

Your support helps maintain and improve this tool for everyone. Thank you! 🙏

</div>

---

Features

• 📇 Card Management - Create, read, update, delete flashcards
• 🔍 Search - Find cards by name or content
• 📚 Deck Organization - Manage decks and organize cards
• 🔄 Pagination - Handle large card collections efficiently
• 🧠 Spaced Repetition - Integrate with Mochi's learning algorithm
• ✨ Markdown Support - Rich formatting for card content

Installation

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "mochi": {
      "command": "npx",
      "args": ["-y", "@louis030195/mochi-mcp"],
      "env": {
        "MOCHI_API_KEY": "your-mochi-api-key"
      }
    }
  }
}

Claude Code

# Install globally in user scope with API key
claude mcp add -s user mochi npx -e MOCHI_API_KEY=your-mochi-api-key -- -y @louis030195/mochi-mcp

Get Your Mochi API Key

1. Go to Mochi Account Settings
2. Sign up or log in
3. Navigate to Settings → Account
4. Copy your API key

Usage

Once configured, you can use natural language to interact with Mochi:

Card Management

• "Create a flashcard about the Krebs cycle"
• "Show me my recent flashcards"
• "Update the card about Python decorators"
• "Delete the card with ID abc123"

Search & Organization

• "Search for cards about machine learning"
• "List all my decks"
• "Create a new deck called 'Spanish Vocabulary'"
• "Find cards containing 'neural networks'"

Study & Review

• "Get the next 20 cards for review"
• "Show me cards from the Biology deck"

Tools

mochi_list_cards

List all Mochi flashcards with pagination support.

Parameters:

• bookmark (string, optional): Pagination bookmark from previous response
• limit (number, optional): Maximum number of cards to fetch (default: 100)

Returns: List of cards with content, IDs, deck info, review status, etc.

mochi_get_card

Get a specific Mochi flashcard by ID.

Parameters:

• card_id (string, required): The ID of the card to retrieve

Returns: Detailed card data including front, back, deck, review history, etc.

mochi_create_card

Create a new Mochi flashcard with front/back content.

Parameters:

• name (string, required): The front/question of the card
• content (string, required): The back/answer of the card (markdown supported)
• deck_id (string, optional): Optional deck ID to add the card to

Returns: Created card data with ID

mochi_update_card

Update an existing Mochi flashcard.

Parameters:

• card_id (string, required): The ID of the card to update
• name (string, optional): The front/question of the card
• content (string, optional): The back/answer of the card (markdown supported)

Returns: Updated card data

mochi_delete_card

Delete a Mochi flashcard by ID.

Parameters:

• card_id (string, required): The ID of the card to delete

Returns: Deletion confirmation

mochi_list_decks

List all Mochi decks.

Returns: List of decks with names, IDs, card counts, etc.

mochi_create_deck

Create a new Mochi deck.

Parameters:

• name (string, required): The name of the deck

Returns: Created deck data with ID

mochi_search_cards

Search for Mochi flashcards by name or content.

Parameters:

• query (string, required): Search query
• bookmark (string, optional): Pagination bookmark from previous response

Returns: List of matching cards

Development

# Clone the repo
git clone https://github.com/louis030195/mochi-mcp.git
cd mochi-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run locally
MOCHI_API_KEY=your-api-key npm start

API Documentation

See Mochi API Docs for full API details.

License

MIT

Author

Louis Beaumont