Flashcards MCP Server
About
MCP server for managing flashcard decks and study sessions with AI-powered generation and spaced repetition
Details
- Author
- No-Smoke
- Downloads
- 245
- Categories
- Other
Jump to
- Create and manage flashcard decks
- Add, update, and delete cards within decks
- Study session management with progress tracking
- Import/export decks in JSON format
- Study metrics and analytics
- Local storage with persistence
- UI workflow integration for human‑in‑the‑loop interactions
- Interactive study sessions with direct feedback
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Flashcards MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with npm install, build with npm run build, then start the server with npm start. The server runs on stdio and is compatible with Claude Desktop and other MCP clients. Add it to your Claude Desktop configuration using the provided mcpServers entry.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"flashcards mcp server": {
"flashcards": {
"command": "node",
"args": [
"/path/to/flashcards-mcp-server/build/src/index.js"
]
}
}
}
}McpServers
{
"flashcards": {
"command": "node",
"args": [
"/path/to/flashcards-mcp-server/build/src/index.js"
]
}
}Flashcards MCP Server
An MCP (Model Context Protocol) server for managing flashcards with AI generation and study tracking capabilities.
Features
- Create and manage flashcard decks
- Add, update, and delete cards within decks
- Study session management with progress tracking
- Import/export decks in JSON format
- Study metrics and analytics
- Local storage with persistence
- NEW: UI workflow integration for human-in-the-loop interactions
- NEW: Interactive study sessions with direct feedback
Installation
1. Clone this repository
2. Install dependencies:
npm install
3. Build the project:
npm run build
Usage
Starting the Server
npm start
The server runs on stdio, making it compatible with Claude Desktop and other MCP clients.
Available Commands
Deck Management
-create_deck: Create a new flashcard deck
- list_decks: List all available decks
- get_deck: Get details of a specific deck
- delete_deck: Delete a deck
Card Management
-add_card: Add a card to a deck
- update_card: Update an existing card
- delete_card: Delete a card from a deck
Study Sessions
-start_study_session: Begin a study session
- complete_study_session: Finish a session and record results
- get_study_metrics: Get study statistics for a deck
Import/Export
-import_deck: Import a deck from JSON format
- export_deck: Export a deck to JSON format
UI Workflow Integration (v1.1.0+)
-startFlashcardSession: Initialize a UI workflow session
- showFlashcardPrompt: Display UI elements for user interaction
- updateFlashcardSession: Manage workflow state and progress
- getFlashcardSessionStatus: Check workflow status
UI Workflow Integration
The Flashcards MCP Server now includes UI workflow capabilities that enable human-in-the-loop interactions directly within Claude Desktop. This allows for:
- Interactive deck creation with step-by-step guidance
- Guided study sessions with immediate feedback
- Import workflows with preview and confirmation
- Progress tracking for multi-step operations
Example UI workflow usage:
// Start a deck creation workflow
const session = await startFlashcardSession({
type: "create_deck",
metadata: {
deckName: "JavaScript Basics",
description: "Core JS concepts"
}
});
// Show interactive UI for card creation
await showFlashcardPrompt({
sessionId: session.id,
promptType: "card_content",
data: {
currentStep: 1,
totalSteps: 5
}
});
Configuration
Claude Desktop Configuration
Add to your Claude Desktop config file:
{
"mcpServers": {
"flashcards": {
"command": "node",
"args": ["/path/to/flashcards-mcp-server/build/src/index.js"]
}
}
}
Data Storage
Data is stored in ~/.flashcards-mcp/ by default:
- decks.json: All flashcard decks
- history.json: Study session history
Development
Running in Development Mode
npm run dev
Running Tests
npm test
Building
npm run build
Example Usage with Claude
Human: Create a new deck called "JavaScript Basics"
Claude: I'll create a new deck for you.
I've created a new deck called "JavaScript Basics".
Would you like to start adding cards to this deck now?
Documentation
- UI Workflow Documentation - Guide to UI workflows
- UI Tools Reference - Quick reference for UI tools
- Migration Guide - Upgrade guide between versions
- Release Notes - Version history and changelog
- Analytics Dashboard Architecture - Analytics system design
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
