flashcards-mcp

An MCP server for making flashcards with your agents and being quizzed on them. SM-2 spaced repetition. Effect on Durable Object SQLite, deployed with Alchemy.

Setup

Needs a domain on your Cloudflare account and a Cloudflare Zero Trust organisation (free up to 50 users).

Create a GitHub OAuth app at https://github.com/settings/developers with the callback URL https://YOUR-TEAM.cloudflareaccess.com/cdn-cgi/access/callback, then write .env:

GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
ACCESS_TEAM=https://YOUR-TEAM.cloudflareaccess.com

Set HOSTNAME in src/worker.ts to your domain, then:

corepack enable
pnpm install
pnpm deploy

pnpm logs tails the Worker. pnpm destroy removes everything.

Related MCP server: TalkToAnki

Auth

Cloudflare Access sits in front of the domain; each signed-in email gets its own deck in its own Durable Object. MCP clients log in via managed OAuth — enable it on the Access application through the Cloudflare dashboard, and re-check it after changing that resource, since updates can drop it.

claude mcp add --transport http flashcards https://YOUR-DOMAIN/mcp

Tools

add_card · list_decks · get_due_cards · reveal_card · grade_card · edit_card · search_cards · delete_card · card_history · stats

Quiz flow: get_due_cards → ask the front → reveal_card → grade_card (0–5; below 3 resets the interval).