flashcards-mcp

A spaced repetition flashcard MCP server for Claude. Uses the FSRS-5 algorithm (successor to Anki's SM-2) with an interactive card UI, text-to-speech, and image support.

Install

npx (quickest)

npx flashcards-mcp

Add to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "flashcards": {
      "command": "npx",
      "args": ["flashcards-mcp"]
    }
  }
}

curl (auto-configures Claude)

curl -fsSL https://raw.githubusercontent.com/zcsabbagh/flashcards-mcp/main/install.sh | bash

Homebrew

brew tap zcsabbagh/tap
brew install flashcards-mcp

Then add to ~/.claude/.mcp.json:

{
  "mcpServers": {
    "flashcards": {
      "command": "flashcards-mcp"
    }
  }
}

Usage

After restarting Claude, try:

• "create a deck called Algorithms" — creates a new deck
• "add a card: What is Big O? / A notation for algorithm time complexity" — adds a card
• "get due cards" — opens the interactive flashcard UI
• "get due cards for deck 1" — filters to a specific deck

Keyboard shortcuts (in the flashcard UI)

| Key | Action | |-----|--------| | Space / Enter | Flip card | | 1-4 | Rate (Again, Hard, Good, Easy) | | Arrow Left/Right | Previous/Next card | | V | Toggle voiceover (requires ElevenLabs API key) |

Images

Cards support images on front and back faces:

"add a card with front_image from /path/to/image.png"
"set card 5 front image to https://example.com/photo.jpg"

Text-to-Speech

Add your ElevenLabs API key to the MCP config:

{
  "mcpServers": {
    "flashcards": {
      "command": "npx",
      "args": ["flashcards-mcp"],
      "env": {
        "ELEVENLABS_API_KEY": "sk_..."
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | create_deck | Create a new deck | | list_decks | List all decks with stats | | add_card | Add a single card (supports markdown, images) | | bulk_add_cards | Add multiple cards at once | | get_due_cards | Get due cards with interactive UI | | review_card | Submit a rating (1-4) | | search_cards | Search cards by keyword | | get_deck_stats | Mastery distribution, retention rate | | get_card_image | Lazy-load card images | | set_card_image | Add/replace card images | | tts | Text-to-speech via ElevenLabs | | delete_card | Delete a card | | delete_deck | Delete a deck and all its cards | | get_review_history | Card scheduling history |

How it works

• FSRS-5 algorithm schedules reviews based on stability, difficulty, and elapsed time
• SQLite stores everything locally at ~/.claude/mcp-servers/flashcards/data/flashcards.db
• MCP App UI renders an interactive flashcard widget directly in Claude's chat
• Images stored as base64 in the database, lazy-loaded one at a time
• Markdown supported in card content (code blocks, lists, headers, etc.)

License

MIT