Memora MCP
Review & study: open a single deck (
review_deck) or a whole category subtree (study) as an interactive flip-card UI (flashcards, multiple-choice quizzes, cloze blanks), due cards first.Create content: generate flashcard/cloze decks (
create_deck, with optionalreversefor back-to-front cards) and multiple-choice quizzes (create_quiz), optionally appending to existing decks.Grade & schedule: record review results (
grade_card) to update each card's FSRS spaced-repetition schedule.Manage decks/cards: edit card fronts/backs (
edit_card), rename decks (rename_deck), delete individual cards (delete_card) or whole decks (delete_deck).Get summaries: see what's due today across all decks (
due_today), including per-deck due/new counts and struggling cards.Capture & refine: turn recent mistakes into draft cards (
capture) and propose/apply card refinements (refine_card,apply_refinement).Organize: decks are nested with
::into a category tree; study a branch or browse it as a mind map.Data: decks are stored as plain JSON (read live, atomically written), no database or external service.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Memora MCP create a deck of 10 Spanish verbs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Memora MCP
Turn any conversation into an interactive study session, right inside Claude Desktop. Ask Claude to make a deck and it generates the cards, then renders them as an inline review you can click through: flip flashcards, answer multiple-choice quizzes, and fill in cloze blanks. Every answer updates a spaced-repetition schedule, and your results flow back to Claude so it can drill what you missed.
Keywords: Model Context Protocol, MCP server, MCP Apps, Claude Desktop, flashcards, quizzes, spaced repetition, SRS, FSRS, Anki alternative.
Built on the MCP Apps extension (SEP-1865): core MCP spec 2025-11-25 plus the Apps extension 2026-01-26.
Features
Three ways to study, all rendered inline and all graded the same way:
Flashcards: click to flip, then grade Got it / Missed it.
Multiple-choice quizzes: pick an option and the correct/wrong answers reveal instantly.
Cloze (fill-in-the-blank): the blank reveals in place so the sentence stays intact. Write a blank as
[...]in a card front and it becomes a cloze card automatically.
Spaced repetition: every grade updates a per-card FSRS schedule (via ts-fsrs), so weak cards resurface sooner and due cards come first. Ask "what's due today?" for a summary across all your decks.
Organize with categories: name decks with :: to nest them (e.g. LLM::Attention). Browse the category tree, or the same tree as an interactive mind map, and study a whole branch in one merged session. Quiz decks are flagged with a badge.
Manage your decks: create, append to, edit, rename, and delete decks and cards without leaving the chat. Pass reverse when creating a deck to also drill each card back-to-front (handy for vocabulary).
Just JSON: decks live in data/decks.json, read live on every call. Hand-edit them or let Claude build them. No database, no external service.
Related MCP server: mcp-ankiconnect
The tools
Only review_deck and study open the inline flip-card UI; everything else returns a text summary, so editing or creating in chat no longer pops the widget.
Tool | What it does |
| Open one deck for review (due cards first, capped per session). |
| Review a whole category subtree, merged into one session (capped per session). |
| Generate flashcards or cloze cards; |
| Generate multiple-choice questions. |
| Record a review result and update the card's FSRS schedule (called by the UI). |
| Summarize what is due across all decks, and flag struggling cards (3+ lapses). |
| Change a card's front and/or back. |
| Propose splitting a card into atomic pieces, or rewriting it to test understanding. |
| Persist a refinement after the user approves the proposed cards. |
| Turn something that just burned you (a bug, a missed question) into draft cards. |
| Persist captured cards after the user approves them. |
| Rename a deck (also moves it in the category tree). |
| Remove a single card. |
| Remove a whole deck. |
Card generation follows Memora's quality rules (atomic single-concept cards, 1-5 word answers, active recall, unambiguous, no answer leakage, application over definition), based on Wozniak's 20 Rules of Formulating Knowledge. New cards are linted on write and flagged (never blocked) so Claude can revise them.
How it works (MCP Apps)
A tool declares a ui:// resource. When Claude calls the tool, the host (Claude Desktop) fetches that resource, renders its HTML in a sandboxed iframe, passes the tool result to the UI, and the UI talks back to the host over JSON-RPC (to grade cards and report progress to the model).
Quick start
Prerequisites
Node.js 20.11+
Connect to Claude Desktop
Open Settings > Developer > Edit Config and add Memora under mcpServers:
{
"mcpServers": {
"memora": {
"command": "npx",
"args": ["-y", "@servation/memora-mcp", "--stdio"]
}
}
}Then fully quit Claude Desktop (from the system tray) and relaunch. memora appears under Settings > Developer, pre-loaded with a few sample decks.
Your decks are stored in ~/.memora/decks.json (override the path with the MEMORA_DECKS environment variable). Hand-edit that file or let Claude manage it.
git clone https://github.com/Servation/memora-mcp.git
cd memora-mcp
npm install
npm run buildPoint the config at the built entry with an absolute path (decks then live in the repo's data/decks.json):
{
"mcpServers": {
"memora": {
"command": "node",
"args": ["C:\\path\\to\\memora-mcp\\dist\\main.js", "--stdio"]
}
}
}Try it (in a Claude Desktop chat)
review my World Capitals deckmake me a deck of 10 Spanish travel phrasesmake a reversible deck of 10 Spanish words(drills both directions)make a fill-in-the-blank deck about the water cycle(cloze cards)quiz me with 10 multiple-choice questions on the solar systemturn what we just discussed into a deck called "Photosynthesis"study my LLM categorywhat's due today?
Tech stack
Server: TypeScript,
@modelcontextprotocol/sdkplus@modelcontextprotocol/ext-apps, stdio transport (Streamable HTTP also available).UI: React plus Vite, bundled to a single inlined HTML file via
vite-plugin-singlefile.Scheduling:
ts-fsrs(FSRS).Runtime is plain
nodeonce built (no bun or tsx needed).
Deck format
{
"Deck Name": [
{ "front": "Capital of France?", "back": "Paris" }
]
}Stored in
~/.memora/decks.jsonwhen installed (ordata/decks.jsonfrom source); override withMEMORA_DECKS.Read live (mtime-cached).
create_deck,create_quiz, andgrade_cardwrite here atomically.A quiz card adds
"options": ["...", "..."]; itsbackis the correct option.A cloze card writes the blank as
[...]in the front, with the hidden term as theback.Cards gain a
duedate and an FSRSsrsblock as you review them; cards without them are treated as new.Keep it valid JSON, or the server falls back to a built-in default deck.
Project structure
memora-mcp/
├── server.ts # MCP tools + the ui:// resource
├── decks.ts # data model, decks.json storage, result builder
├── scheduling.ts # FSRS scheduling + review ordering
├── main.ts # entry: stdio (Claude Desktop) or Streamable HTTP
├── mcp-app.html # UI entry HTML (bundled by Vite)
├── src/
│ ├── mcp-app.tsx # review orchestrator (flip / quiz / cloze, grade -> model)
│ ├── deck-lib.tsx # tree, mind map, card list, quiz/cloze views, helpers
│ ├── mcp-app.module.css
│ └── global.css # host theme variable fallbacks (light/dark)
├── data/decks.json # editable decks, read live
├── media/ # README images
├── vite.config.ts # single-file bundle config
└── tsconfig*.jsonDevelopment
npm run dev # vite watch (UI) plus tsx server on http://localhost:3001/mcp
npm run typecheck # tsc --noEmitFor fast local iteration you can also run the app against the MCP Apps reference host (basic-host) from the ext-apps repo.
Roadmap
See TODO.md for the backlog: npm + MCP Registry publishing, cross-client hosting (Streamable HTTP), tests around parsing and scheduling, and a real screen-capture demo GIF.
License
Available Tools
10 toolscreate_deckCreate DeckA
Create (or extend) a flashcard deck from cards you generate based on the user's request or the current conversation, then display it for review. Use "::" in deck_name to nest under a category (e.g. "LLM::Attention"). The deck persists to data/decks.json.
Follow Memora's card-quality rules (based on Wozniak's '20 Rules of Formulating Knowledge'). The front is the prompt/question, the back is the answer:
Minimum information (atomic): each card tests exactly one fact or concept. Split complex material into several simple cards; never ask for lists or paragraph answers.
Concise answers: the back is ideally 1-5 words (a name, date, term, or single concept), never a sentence or paragraph.
Active recall: make the front a specific question (not 'Explain X'), or a cloze deletion: write the blank as "[...]" in the front and the hidden term as the back (e.g. front "The Transformer was introduced in [...].", back "2017").
Unambiguous: each front must point to exactly one correct answer.
Set reverse=true to also add the back->front version of each non-cloze card (useful for vocabulary or term/definition pairs that should be drilled both ways).
Inputs: cards (required), deck_name (required), append, reverse. Returns: deck, cards, count, dueCount, +3 more
create_quizCreate QuizA
Create (or extend) a multiple-choice quiz deck from questions you generate based on the user's request or the conversation, then display it for review. Use "::" in deck_name to nest under a category. Persists to data/decks.json and is reviewed like flashcards with spaced repetition.
Each question: a clear, specific prompt; 3 to 4 concise options with exactly ONE correct answer and plausible (not obviously wrong) distractors. The answer must match one of the options exactly.
Inputs: deck_name (required), questions (required), append. Returns: deck, cards, count, dueCount, +3 more
delete_cardDelete CardA
Delete a single card from a deck, identified by its front text. Refuses to delete a deck's last card (delete the deck instead).
Inputs: front (required), deck_name (required). Returns: deck, cards, count, dueCount, +3 more
delete_deckDelete DeckA
Delete a deck and all its cards. Refuses to delete the only remaining deck.
Inputs: deck_name (required).
due_todayDue TodayA
Summarize what is due to review right now across all decks: per-deck and total due/new counts. Pull-based (call it to see the summary); it does not appear on its own.
Inputs: no named parameters. Returns: date, decks, totalDue, totalNew
edit_cardEdit CardA
Edit a card's front and/or back in a deck, identified by its current front text, then re-render the deck. Keep edits within Memora's card-quality rules (atomic, concise 1-5 word answers, unambiguous).
Inputs: front (required), deck_name (required), new_back, new_front. Returns: deck, cards, count, dueCount, +3 more
grade_cardGrade CardA
Record a spaced-repetition review result for a single card and update its FSRS schedule in data/decks.json. Called by the flip-card UI; not for direct model use.
Inputs: front (required), correct (required), deck_name (required).
rename_deckRename DeckA
Rename a deck, preserving its cards and schedules. Use "::" in the new name to move it under a category. Fails if a deck with the new name already exists.
Inputs: new_name (required), deck_name (required). Returns: deck, cards, count, dueCount, +3 more
review_deckReview DeckA
Return the flashcards of a single Memora deck and display them as an interactive flip-card review (due cards first). Available decks: "Geography::World Capitals", "Geography::Rivers", "Science::Solar System", "Language::Spanish Basics". Deck names use "::" to form a category tree; use the study tool to review a whole category. Decks are read live from data/decks.json.
Inputs: deck_name. Returns: deck, cards, count, dueCount, +3 more
studyStudy CategoryA
Study every card under a category node of the deck tree. Deck names use "::" to nest (e.g. "LLM::Attention"); studying a node reviews all decks at or under that path, merged and shuffled into one session. Omit path to study all decks. Each card stays attributed to its source deck.
Inputs: path. Returns: deck, cards, count, dueCount, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct action: deck/quiz creation, card/deck deletion, editing, renaming, reviewing single decks or categories, grading, and summary. No two tools have overlapping purposes; descriptions clearly differentiate them.
Most tools follow a verb_noun pattern (create_deck, delete_card, etc.), but 'due_today' is a noun phrase and 'study' is a bare verb, breaking the consistency. This mix could confuse an agent predicting tool names.
10 tools is well-scoped for a flashcard/quiz application. Each tool serves a necessary function in the creation, management, review, and scheduling lifecycle without being excessive or sparse.
The tool set covers CRUD operations, review, and scheduling. However, there is no tool to list all decks or view cards without triggering a review session, which is a minor gap that could hinder agent workflows.
Maintenance
Related MCP Connectors
Create and review spaced-repetition flashcards in your free Klappa decks from any AI assistant.
Read, write, and conversationally review open-source flashcards through split read/write MCP tools.
Build and study spaced-repetition flashcards with your agent.
Spaced-repetition flashcards your AI writes, quizzes you on by voice, and schedules with FSRS.
Related MCP Servers
- AlicenseAqualityDmaintenanceIntegrates EduChain's educational content generation capabilities with Claude Desktop, enabling creation of multiple-choice questions, comprehensive lesson plans, and flashcards for any educational topic.31MIT
- AlicenseNot gradedqualityNot gradedmaintenanceConnects Claude to Anki flashcard software via AnkiConnect, enabling users to review due cards, create flashcards, and manage spaced repetition learning through natural language conversations.MIT
- AlicenseCqualityCmaintenanceFlashcard AI - MCP server providing AI-powered tools and automation by MEOK AI Labs42 npm42 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceStudent productivity MCP. Ask Claude what assignments are due, calculate grades needed, summarize notes, review flashcards. Works with Google Classroom and Gemini AI.48MIT