Obsidian community plugin

Turn notes and PDFs into practice.

MCQ Tracker is an Obsidian plugin for exam practice. Turn your notes into questions, import free-response items from a PDF, and keep every attempt, explanation and next review date on the note it came from.

Free & MIT · Desktop and mobile · No account

For AP, university and professional exam prep. Uses the vault you already have, with AI off until you configure it.

MCQ Tracker Practice view in Obsidian showing a metabolism multiple-choice question, four choices, a timer, confidence buttons and Submit.
PracticeOne question at a time, with a timer, confidence buttons and the review date saved on submit.

At a glance

What the four numbers mean.

The README summarises the plugin in four numbers. Here is exactly what each one counts, without the abbreviations.

7

Question formats

Multiple choice, student-produced response, fill-in, matching, true/false, select-all and free response. Each one is an ordinary note, graded in the same Practice view.

3

Review schedules

A simple interval ladder is the default for questions. FSRS and SM-2 are available for cards and whole notes. The chosen schedule and its history live in the note.

21

Study Workspace tabs

An optional workspace, not 21 separate plugins. Every tab has its own switch and its own local data. The full list is below.

0

Telemetry

No analytics, crash reporting, ads or self-updater. Network calls happen only in features you configure: AI, CouchDB sync, calendar feeds or AnkiConnect.

01Practice

One question at a time, in the format the exam uses.

Practice is one note per question by default. Write it in Markdown, import a question bank, or turn a PDF into free-response items. Submit an answer and the result goes back to the same file.

Seven answer formats

Multiple choice, select-all, true/false, student-produced response, fill-in, matching and free response, with hints, cross-out, flags and per-question timing.

Feedback that stays

The correct answer, explanation, confidence, mistake tag and next review date are written to the note.

Timed tests

Build multi-section tests with resume, a question navigator, mark-for-review, option shuffle, a pass mark and Bluebook-style tools.

Practice result showing an incorrect answer, the correct choice, mistake tags, a notes field and the next review controls.
After SubmitThe correct choice and explanation, the reason for the miss, and the next review date — all on the note.
02Review

The schedule follows the miss.

Questions, cards and whole notes share one review history. A wrong answer returns tomorrow; a right one moves along its schedule. Whole-note review docks under the note and previews the interval for each rating before you press it.

Interval ladderDefault for questions
1, 3, 7, 21 and 60 days. A miss returns tomorrow; a correct answer moves up one step.
FSRSCards and whole notes
The ts-fsrs 5.4.1 model with its shipped weights. Memory state is stored in the note.
SM-2Cards and whole notes
The classic ease-factor schedule. Review history remains the source of truth.

The review sidebar and due calendar read that same history. Nothing is copied into a second database.

Insights Overview with grades, course health, FSRS depth, due load, study activity and accuracy.
InsightsAttempts, accuracy, retention, due load and course health, calculated from the vault.
03Cards & tests

Cards and exam week, without a second app.

Use cards when recall is the unit and timed tests when the exam is. Both read and write the same notes as Practice.

Cards

Flip, cloze, reversed, typed and image-occlusion cards. Decks, vocabulary, cram sessions, .apkg import and export, AnkiConnect to Anki desktop, and an AnkiWeb deck search that opens in your browser.

Tests

Timed sections, resume, a question navigator, mark for review, option shuffle, a pass mark, AP-style free response, a gradebook and a calendar.

Cards view with two flashcards ready to review, deck and course filters, and a Start review button.
CardsDue counts, deck and course filters, and the review queue. Cram uses short fixed intervals; Mother cram never changes a due date.
04Study tools

Twenty-one tabs, each with its own switch.

The Study Workspace is optional. It adds local workflows for planning, reading, recall and revision. Each of the 21 tabs can be turned off, and each keeps its own local data.

All 21 tabs

  • Feynman
  • Recall
  • Topic planner
  • Study Flow
  • Subjects
  • Courses
  • Tasks
  • Time blocks
  • Annotations
  • Deep Notes
  • Retention
  • Vocabulary
  • Reading library
  • Citations
  • Quiz index
  • Course health
  • Lecture notes
  • Read aloud
  • Bookmarks
  • AI feedback
  • PDF annotations

The Study agent is optional too.

Private tutor, Socratic tutor, Objective coach and Language partner roles. It answers from cited vault notes and PDF pages, proposes file changes, and waits for your approval. Off until you configure a provider.

One everyday step needs AI: turning a PDF, PowerPoint or Word file into question notes. There is no offline converter; the import uses the provider key you configure, or the OpenCode agent on desktop. Writing questions by hand, practice, review, cards, the calendar and the reference tools all work without AI.

05Data

Your vault is the database.

Review state is YAML frontmatter on the note, not a row in a private database. It travels with the vault, survives a plugin reinstall and stays readable in a text editor or Dataview.

---
question_id: BIO-001
course: Biology
skill: Cells
question_type: mcq
answer: B
---
The frontmatter of a question note. Attempts, flags and review dates are added to the same file.

What leaves the vault

  • Nothing by default. No analytics, crash reporting, ads or self-updater.
  • AI only when you ask. Only the text a request needs goes to the provider you configured.
  • Other network features are explicit. CouchDB sync, calendar feeds and AnkiConnect are off until you turn them on; AnkiConnect talks to your local Anki desktop.
06Install

Install from inside Obsidian.

MCQ Tracker is a community plugin. There is no account or sync service; install it from Obsidian or use the latest release manually. New to Obsidian? Install Obsidian and create a vault first; the Start here note teaches the rest.

  1. Open Community plugins

    In Obsidian, go to Settings → Community plugins and turn off Restricted mode if it is on.

  2. Find MCQ Tracker

    Choose Browse, search for MCQ Tracker and open the result by Isaac Friedenson.

  3. Install and enable

    Click Install, then Enable. The MCQ Tracker Start here note opens with a five-minute Obsidian primer and paths for AP students, regular Obsidian users and power users. The interactive guide also offers a ready-made question you can skip.

Feedback

Tell us what got in the way.

Two minutes, no account. Say what you study, what is missing and what broke. The form only opens when you click it.