# VocabBot

> For Polish speakers: English, German, Spanish, French and Italian vocabulary from A1 to B2, with FSRS spaced repetition in Claude, ChatGPT, a terminal or a browser.

VocabBot runs a daily vocabulary routine in one, two or three languages at once. Spaced repetition helps you retain every word, and you can study in Claude, ChatGPT, the terminal or your phone's browser. The A1 to B2 courses are designed for Polish speakers.

- Website: https://vocabbot.run/
- MCP server address: https://vocabbot.run/mcp
- Languages taught: English, German, Spanish, French, Italian
- Levels: A1, A2, B1, B2 (CEFR)
- Base language of the courses: Polish
- Scheduling: FSRS-6 spaced repetition, 90% retention by default
- Works with: Claude, ChatGPT, Claude Code, Codex, a web browser and a terminal
- Licences: code under Apache-2.0, courses under CC BY-SA 4.0
- Version: 1.0.0rc14

## How it works

The same engine grades your answers and schedules your reviews in every app. Every answer goes into one learning plan, whichever device you use.

- **Spaced repetition**: The FSRS-6 algorithm schedules each review so that a word comes back before you forget it.
- **Up to three languages at once**: English, German, Spanish, French and Italian, from A1 to B2. Words from your chosen languages are interleaved in a single session.
- **One account on every device**: Your account connects the chat app, the terminal and your phone. A session started on one device can be finished on another.
- **The engine grades every answer**: Grades, review dates and statistics come from VocabBot's engine. The assistant leads the conversation but cannot change a grade.

## Three stages of every study day

A session takes a few minutes a day and always follows the same order. You can move between the stages at any time.

1. **Reviews**: A session starts with the words scheduled for the day. The most overdue cards come first.
2. **New words**: New words arrive in order of frequency. A card shows the Polish meaning, the part of speech and an example sentence with a gap.
3. **Drill**: Every word answered incorrectly returns on the same day until you answer it correctly.

## Five languages from A1 to B2

The courses are designed for learners whose base language is Polish. Entries include the Polish meaning, forms, pronunciation and an example sentence.

| Language | A1 | A2 | B1 | B2 | Total |
|---|---:|---:|---:|---:|---:|
| English | 1079 | 1253 | 1919 | 2035 | 6286 |
| German | 1016 | 1162 | 1724 | 1747 | 5649 |
| Spanish | 1009 | 1126 | 1713 | 1733 | 5581 |
| French | 1004 | 1140 | 1704 | 1731 | 5579 |
| Italian | 1003 | 1134 | 1681 | 1758 | 5576 |

The courses are built from open data: the CEFR-J wordlist, Wiktionary, wordfreq and Tatoeba. They are available under the CC BY-SA 4.0 licence.

## Connect VocabBot to the assistant you already use

Add the server address in any app that supports MCP servers and sign in with the same account on every device.

- **Claude** (Web, desktop and mobile apps): Open “Customize”, go to “Connectors”, choose “Add”, then “Add custom connector” and paste the server address.
- **ChatGPT** (Paid plans): Open `chatgpt.com/plugins`, click “+” and choose “Add custom MCP server”. Enter the server address and select OAuth authentication.
- **Browser** (No chat app required): The learning session is available at `/app/`. You can also add the page to your phone's home screen.
- **Claude Code and Codex** (Terminal): Add the server with one command, then sign in through your browser: with `/mcp` in Claude Code or with `codex mcp login vocabbot` in Codex.

```
claude mcp add --transport http vocabbot https://vocabbot.run/mcp
codex mcp add vocabbot --url https://vocabbot.run/mcp
```

## Frequently asked questions

### What is VocabBot?

VocabBot is a vocabulary trainer based on spaced repetition. It runs a daily session in a chat app such as Claude or ChatGPT, in a terminal or in a browser. Its engine grades every answer and schedules the next review.

### Which languages can I learn?

The courses cover English, German, Spanish, French and Italian from A1 to B2. A learning plan can include one, two or three languages at once. The courses are designed for Polish speakers.

### How does spaced repetition work?

Each word returns after a progressively longer interval. The FSRS-6 algorithm schedules a review so that the probability of a correct answer is 90% by default. A word answered incorrectly returns on the same day.

### Which apps does VocabBot work with?

VocabBot works as a remote MCP server in Claude, ChatGPT, Claude Code and Codex. You can also study in a browser at /app/ and in a terminal with the vocabbot program.

### Do I need a chat app to study?

No. The session page works in desktop and mobile browsers, and the vocabbot program runs the same session in a terminal. Every way of studying uses one account and one learning plan.

### Can the AI assistant change a grade?

No. VocabBot's engine grades answers according to the rules of each language. The assistant leads the conversation and explains meanings, but grades, review dates and statistics come only from the engine.

### How do I create an account?

Accounts are created with an invitation code from the server administrator. After signing in, you can set up a learning plan with or without a placement test.

### Where do the courses come from?

The courses are built from open data. Levels come from the CEFR-J wordlist, translations, forms and pronunciation from Wiktionary, word order from wordfreq, and example sentences from Tatoeba. The courses are available under the CC BY-SA 4.0 licence.

### Is VocabBot open source?

Yes. The code is available on GitHub under the Apache-2.0 licence. You can run the server yourself, and the vocabbot program also works offline.

### What data does the server store?

The server stores your username, a password hash, your learning plan, the answer log, your own words and notes. On the account page you can download all your data and delete the account. The Privacy page has the details.

## Links

- [Start page in Polish](https://vocabbot.run/)
- [Start page in English](https://vocabbot.run/?lang=en)
- [Learning session in the browser](https://vocabbot.run/app/)
- [Privacy](https://vocabbot.run/privacy?lang=en)
- [Source code](https://github.com/dithiothreitol/vocabbot)
- [Python package](https://pypi.org/project/vocabbot/)

## Po polsku

Nauka słownictwa angielskiego, niemieckiego, hiszpańskiego, francuskiego i włoskiego od A1 do B2. Powtórki FSRS w Claude, ChatGPT, terminalu i przeglądarce.

VocabBot prowadzi codzienną naukę słownictwa w jednym, dwóch lub trzech językach jednocześnie. Powtórki rozłożone w czasie utrwalają każde słowo, a naukę można prowadzić w Claude, ChatGPT, terminalu lub przeglądarce telefonu. Kursy od poziomu A1 do B2 są przeznaczone dla osób polskojęzycznych.
