Documentation / MCP Server v1

Flashcards connector
for Claude.

Flashcards is a remote MCP server that lets Claude turn anything you paste — a tutor's notes, a page of vocabulary, a chapter summary — into spaced-repetition decks, and then quiz you back. This page is the working manual: install it, see what the model can do with it, and self-serve when something looks off.

Server
flashcards.starters.app
Transport
Streamable HTTP
Auth
OAuth · Google
Tools
8 exposed
Status
Beta · free
Operator
byvshev.dev
Setup · 2 minutes

Install in Claude.

Flashcards is a remote MCP server, so installation is just adding a custom connector in Claude and approving it. There is nothing to download and no command line. Two routes are supported — the one-click button (after signing in on this site) or a manual install with the URL below.

Manual install

Add Flashcards as a custom connector in Claude using the remote MCP server URL:

MCP URL https://flashcards.starters.app/mcp
  1. In Claude, open Customize → Connectors, then click the + button and choose Add custom connector. Web, desktop, and the iOS / Android apps all expose this menu.
  2. Paste https://flashcards.starters.app/mcp as the server URL, give it a name (e.g. Flashcards), and click Add. No Advanced settings needed — the server handles its own OAuth.
  3. Claude opens the OAuth window. Sign in with Google and approve the requested scopes. Claude never sees your password — the token comes back via OAuth.
  4. Open or start a chat, click the + in the lower-left of the composer, choose Connectors, and toggle Flashcards on for that conversation.
  5. Ask Claude: "Build a deck from these notes." Paste the notes; the model will call createDeck + createCards automatically.
Plan availability. Custom connectors are available on every Claude plan — Free (one connector max), Pro, Max, Team, and Enterprise. On Team / Enterprise, only organization Owners can add a connector; members then enable it from Customize → Connectors. Custom connectors are in beta on Anthropic's side, per their official guide.

One-click install

If you'd rather not paste a URL: sign in on the marketing page and Claude will be handed a pre-filled install link. Take the one-click route.

Capabilities

What it does.

The connector exposes two surfaces to the model: authoring (build decks and cards from raw source material) and practice (pull the next due card, grade your recall, advance the schedule). Scheduling is handled server-side by the FSRS algorithm — Claude only asks for the next card and reports back how well you did.

  • Authoring. Paste a tutor's notes, a glossary, a chapter — Claude reads, splits, and writes the cards.
  • Practice. Ask Claude to quiz you; it pulls one card at a time, scores your answer, and moves on.
  • Library. List, rename, and delete decks. Cards are scoped to the signed-in Google account.
  • Persistence. Your decks live in Postgres in the EU (Frankfurt). They're not regenerated each session.
Out of scope. The connector does not import from Anki, does not sync to other apps, and does not expose review history as a tool (only the next-due card). If your workflow needs any of those, email contact@byvshev.dev — these are on the shortlist.
8 tools · grouped

Tools reference.

Claude picks which tool to call from natural language; you should rarely need to name them. The list below is for when you're auditing what the model did, or writing prompts that nudge it toward a specific shape.

Decks

createDeck write

Create a new flashcard deck under your account.

name·string ≤ 255
listDecks read

List every deck you own, with card counts.

— no args —
deleteDeck write

Delete a deck and every card inside it. Irreversible.

deckId·long > 0

Cards

createCards write

Create up to 100 cards in a deck in one transaction.

deckId·long
cards[]·{ front, back }
listCards read

List every card in a deck, including review state.

deckId·long
deleteCards write

Delete one or more cards by ID. Idempotent.

cardIds[]·long, ≤ 100

Review

getNextCard read

Return the next card due for review in a deck.

deckId·long
reviewCard write

Grade a card; FSRS schedules the next interval; the next due card is returned.

cardId·long
rating·AGAIN | GOOD | EASY
Identity

Auth & sessions.

The MCP endpoint at /mcp is bearer-token authenticated. Claude obtains that token through OAuth against our Keycloak realm, brokered by your Google account. From your side this is one tap; from the server's side, the token identifies the account that owns every deck and card that gets created or read.

  • Identity provider. Google (via Keycloak 26 OIDC).
  • Scopes. Profile + email. The server stores your name, email, and Google subject ID — nothing else from Google.
  • Token lifetime. Short-lived access tokens; Claude refreshes them transparently.
  • Multi-account. One Claude connector = one account. Reinstall to switch.
Self-serve

Debug & troubleshooting.

The most common issues fall into a small handful of shapes. Skim before emailing — odds are good your answer is below.

The "Add custom connector" option is missing in Claude.

Three usual causes. One — you're on Claude Free and have already added one custom connector (Free is capped at one). Two — you're a member of a Team or Enterprise workspace; only Owners can add connectors there, so ask your Owner to add Flashcards from Organization settings → Connectors, after which you'll see it in Customize → Connectors. Three — the option lives under Customize → Connectors (not Settings); confirm you're looking in the right place via the official guide.

OAuth window won't open / loops back to "Sign in".

Third-party cookies blocked in your browser is the usual culprit. Allow cookies for flashcards.starters.app and accounts.google.com, then retry the install. On Safari, disable Prevent cross-site tracking for the duration of the install only.

Claude says "no cards due for review in deck".

That's not an error — it's FSRS telling you you're up to date. The next card won't be due until its scheduled interval elapses. Ask Claude to list cards in the deck to see when each one is next due.

Tool calls return "Entity not found".

The deckId or cardId you (or Claude) referenced doesn't belong to your account — either it was deleted, or it lives under a different Google account. Ask Claude to call listDecks first and pick a fresh ID.

The connector worked yesterday — today everything 401s.

Token revoked or your Google session lapsed. Open Customize → Connectors, hit Disconnect on Flashcards, then Connect again. Re-auth takes about ten seconds. You can revoke access on Flashcards' side at any time from your Google account permissions.

Claude doesn't seem to be calling Flashcards at all.

Connectors are toggled per conversation. Click the + in the lower-left of the composer, choose Connectors, and make sure Flashcards is switched on for the current chat. New conversations start with whatever set was last enabled.

I want to inspect the raw MCP traffic.

Run the official inspector against the server URL: npx @modelcontextprotocol/inspector https://flashcards.starters.app/mcp. Paste your bearer token and you can watch every tool call as JSON-RPC.

What we store

Data & privacy.

The server stores three things: who you are (Google identity, via Keycloak), the decks and cards you've created, and anonymous-or-identified usage events (sign-in, install, review). Everything lives in Postgres in the EU (Frankfurt). The full policy, including subprocessors and your GDPR rights, is on the privacy page.

  • Card content is yours; you grant only the licence needed to host and display it.
  • Delete on request. Email contact@byvshev.dev and we wipe your account inside 30 days.
  • No ads, no third-party tracking beyond product analytics on a self-hosted EU PostHog instance.
Real people · one inbox

Get support.

Flashcards is developed and operated by byvshev.dev — a small independent studio that ships a handful of focused, self-funded products. No ticketing system, no support queue, no shared inbox: every message goes to the person who wrote the server. Reasonable response: under 24 hours on weekdays.

Contact · byvshev.dev

Send a postcard.

Bug reports, feature ideas, "is this still alive?" — all welcome. Include the deck name (if relevant) and a screenshot of Claude's error toast and we'll usually have the cause inside one reply.

Email contact@byvshev.dev Studio byvshev.dev Privacy policy Terms of service