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 deckget_card- Retrieve a single card by IDcreate_card- Create a new flashcardupdate_card- Update an existing carddelete_card- Permanently delete a cardadd_attachment- Upload file attachments to cardsdelete_attachment- Remove attachments from cards
Decks
list_decks- List all decksget_deck- Retrieve a single deck by IDcreate_deck- Create a new deckupdate_deck- Update deck propertiesdelete_deck- Permanently delete a deck
Templates
list_templates- List all templatesget_template- Retrieve a template by IDcreate_template- Create a new card template
Due Cards
get_due_cards- Get cards due for review (spaced repetition)
Installation
bun installConfiguration
This server requires a Mochi API key. To get your API key:
- Open the Mochi Cards app
- Go to Account Settings
- 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 startLicense
MIT
