Clozemaster CLI MCP server
Commit Nov 11, 2026Allows AI assistants to manage language learning collections by writing sentences, translations, and clozes directly into Clozemaster.
Also known as langovation/clozemaster-cli
- Stars
- 5
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 11, 2026
- License
- MIT
What is Clozemaster CLI MCP?
Clozemaster CLI allows AI assistants to manage language learning collections by writing sentences, translations, and clozes directly into Clozemaster. It exposes 7 tools, such as list_language_pairings, list_collections, create_collection.
Summary generated from the project's README
About Clozemaster CLI MCP server
Managing language learning collections through AI assistants is what clozemaster-cli enables. This local MCP server allows Claude, Cursor, and other compatible AI clients to interact directly with your Clozemaster account to organize and populate your study materials. By running over stdio, the server works in the background using the same credentials you use for the terminal-based game.
Users can automate the creation of study sets by asking an AI to generate specific content. The server provides tools to list language pairings, view collections, and manage individual sentences. While basic viewing is available to all, advanced features like create_collection, add_sentences, update_sentence, and delete_sentence require a Clozemaster Pro account. It is designed for developers and language learners who want to use AI to build custom vocabulary lists without manual data entry.
What you can do with it
- 1Automated vocabulary buildingAsk an AI assistant to generate and add a specific number of sentences about a topic to a language collection.
- 2Collection organizationUse an AI to browse your existing language pairings and collections to find specific study sets.
Written from the project's README. Every use case is checked against a quote from it.
Clozemaster CLI MCP tools 7
Detected from the READMElist_language_pairingslist_collectionscreate_collectionlist_sentencesadd_sentencesupdate_sentencedelete_sentence
| list_language_pairings | — | |
| list_collections | — | |
| create_collection | — | |
| list_sentences | — | |
| add_sentences | — | |
| update_sentence | — | |
| delete_sentence | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablelangovation/clozemaster-cli is public and reachablegithub.com/langovation/clozemaster-cli ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/langovation/clozemaster-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubClozemaster CLI
One clozemaster command does two things:
- CLI: play Clozemaster in your terminal, with multiple choice, text input, listening or flashcards, and pixel art.
- MCP server: let Claude and other AI apps write sentences into your own Clozemaster collections.
Both use the same install and the same login.
https://github.com/user-attachments/assets/2fcd2f4b-a4c4-4692-9848-4a7160cb1b7c
Install
One line installs a clozemaster command on macOS or Linux:
curl -fsSL https://www.clozemaster.com/install-cli.sh | sh
The installer downloads the executable for your platform from the latest GitHub release and checks it against the release's SHA256SUMS. That catches a corrupted or truncated download; it isn't a signature, so it doesn't prove who built the file.
CLI: play in your terminal
Type clozemaster to play. The first time, it asks you to log in with your browser.
Commands
| Command | What it does |
|---|---|
clozemaster |
Play (logs you in first if needed) |
clozemaster login |
Log in again with your browser |
clozemaster logout |
Forget your login on this machine |
clozemaster --version |
Print the version (also -v or version) |
Keys
While playing: 1-4 picks an answer, → gives one hint per sentence, tab switches answer mode, p replays the audio, h replays it at half speed, e explains the sentence, s opens settings and esc goes back to the menu. In flashcards, space reveals, then 1 again, 2 good or k known. Press c on the menu for Quick Capture and f to email feedback to support@clozemaster.com.
MCP: let AI apps manage your collections
clozemaster mcp lets an AI app write sentences straight into your own Clozemaster collections. Ask it something like "add 10 sentences about cooking to my German collection" and it writes the sentences, translations and clozes for you.
How it works
It's a local MCP server that talks over stdio. Your AI app starts it in the background whenever it needs it, so you never run it yourself. It uses the login saved by clozemaster. If you haven't logged in yet, the first request opens your browser to log in, and the AI can carry on once you approve it.
Tools
| Tool | What it does |
|---|---|
list_language_pairings |
The languages you're learning, with the ids the other tools need |
list_collections |
Your own collections in a language |
create_collection |
Make a new, empty collection (needs Clozemaster Pro) |
list_sentences |
Page through a collection's sentences |
add_sentences |
Add sentences to a collection (needs Clozemaster Pro) |
update_sentence |
Change a sentence's text and translation (needs Clozemaster Pro) |
delete_sentence |
Delete a sentence (needs Clozemaster Pro) |
A typical session: the AI lists your language pairings, picks or creates a collection, then adds sentences to it. It only touches collections you own, and it doesn't play rounds.
Add it to Claude Code
claude mcp add -s user clozemaster -- clozemaster mcp
-s user makes it available in every project, not just the folder you run it in.
Add it to Claude Desktop
Claude Desktop doesn't see your shell's PATH, so give it the full path to the binary. which clozemaster prints it; the installer puts it at ~/.local/bin/clozemaster.
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude Desktop:
{
"mcpServers": {
"clozemaster": { "command": "/Users/you/.local/bin/clozemaster", "args": ["mcp"] }
}
}
Add it to other AI apps
Any app that runs local stdio MCP servers works. Give it the command clozemaster (or its full path) with the argument mcp.
Cursor (~/.cursor/mcp.json) and Gemini CLI (~/.gemini/settings.json) use the same shape as Claude Desktop:
{
"mcpServers": {
"clozemaster": { "command": "clozemaster", "args": ["mcp"] }
}
}
VS Code (.vscode/mcp.json):
{
"servers": {
"clozemaster": { "type": "stdio", "command": "clozemaster", "args": ["mcp"] }
}
}
Codex CLI (~/.codex/config.toml):
[mcp_servers.clozemaster]
command = "clozemaster"
args = ["mcp"]
ChatGPT
Not yet. ChatGPT only connects to remote MCP servers over HTTPS, not to commands on your computer. It needs a hosted Clozemaster MCP server, which doesn't exist yet.
Uninstall
clozemaster logout
claude mcp remove clozemaster # only if you added it to Claude Code
rm ~/.local/bin/clozemaster
rm -rf ~/.config/clozemaster ~/.cache/clozemaster
If ~/.local/bin wasn't already on your PATH, the installer added a line like export PATH="/Users/you/.local/bin:$PATH" to your shell profile: ~/.zshrc for zsh, ~/.bash_profile for bash on macOS, ~/.bashrc for bash on Linux, or ~/.profile for other shells. Delete that line if nothing else needs it.
Development
Needs Node 20 or newer.
git clone https://github.com/langovation/clozemaster-cli.git
cd clozemaster-cli
npm install
npm run dev # run from source
npm test
npm run build # bundles to dist/cli.js
npm link # after a build, puts `clozemaster` on your PATH
npm run install:local # builds the executable and installs it to ~/.local/bin
Environment variables:
CLOZEMASTER_URL: server to play against, e.g.http://localhost:3000(defaulthttps://www.clozemaster.com)CLOZEMASTER_TOKEN: use this API auth token instead of logging inCLOZEMASTER_NO_AUTO_UPDATE: set to1to stop the executable updating itselfCLOZEMASTER_RELEASES_URL: where the executable downloads updates from (default the GitHub releases); the release workflow points it at a local server to test updating before publishing
Release a new version
npm run release -- 0.2.0
From a clean, pushed main, the script:
- Bumps
versioninpackage.json, commits it, tagsv0.2.0and pushes both. - Waits for the release workflow (
.github/workflows/release.yml), which runs the tests, builds an executable for each platform and publishes them withSHA256SUMSas the latest GitHub release.install.shalways downloads from the latest release. - Checks the release has all five files.
- Opens a web repo PR setting
lib/cli/cli-version.txtto the new version. Installed CLIs and MCP servers check that file at most once an hour and, if it's newer, download that release's executable in the background, check it againstSHA256SUMS, check it runs, and swap it in for the next launch, so merge it last. The script looks for the web repo next to this one; setCLOZEMASTER_WEB_REPOif it's elsewhere.
The copy of install.sh served at clozemaster.com lives in the web repo at lib/cli/install-cli.sh.
License
The code is MIT. The Clozemaster name, logo, pixel art and sound effects are not; see TRADEMARKS.md.
Clozemaster CLI MCP questions
What tools does Clozemaster CLI MCP provide?
It exposes 7 tools, including list_language_pairings, list_collections, create_collection, list_sentences, add_sentences.
What can the Clozemaster MCP server do?
It enables AI applications to write sentences, translations, and clozes directly into your personal Clozemaster collections.
How do I log in to the Clozemaster CLI?
The first time you use the CLI, it will prompt you to log in via your web browser.