beook-mcp
# beook-mcp
An MCP server that lets Claude open, read and answer exercises in the [beook](https://beook.ch) desktop app.
Unofficial, not affiliated with ionesoft or any publisher. The AI's answers can be wrong.
## Setup
Requires Windows, the beook app, and Node.js 22.13 or newer.
```bash
git clone https://github.com/MarcBlattmann/beook-mcp.git
cd beook-mcp && npm install
claude mcp add beook --scope user -- node --no-warnings /path/to/beook-mcp/src/index.js
```
Then ask Claude something like "Solve the open exercises in chapter 2 of my workbook."
## Tools
| Tool | Purpose |
| --- | --- |
| `beook_launch` / `beook_status` | Start beook with the debug port and check its state |
| `beook_list_books` / `beook_list_exercises` | Browse books, chapters and exercises |
| `beook_open_exercise` / `beook_read_exercise` | Open an exercise and read it with marked answer fields |
| `beook_fill_answers` | Fill in text, choice, dropdown, drag & drop and ordering answers |
| `beook_screenshot` / `beook_click` | For drawing and image exercises |
## How it works
beook shows its pages in a built-in Chromium. The server starts beook with
`-Dchromium.remote_debugging_port=9222`, reads exercises through that port, and fills answers the
way the app does, so beook saves and syncs them itself.
While beook runs this way, any program on your PC can control it. Restart beook normally when you're done.
## License
MIT
TDQS
Scored across 9 tools
Most tools target distinct actions: listing books/exercises, opening/navigating, reading the current exercise, filling answers, and interacting via screenshot/click. The main potential confusion is between beook_open_exercise and beook_read_exercise, since opening also returns exercise content, but the descriptions make the intended distinction reasonably clear.
All tools use the consistent beook_ prefix and snake_case, with clear action-oriented names. A few names such as beook_status, beook_screenshot, and beook_click are noun/short-form rather than verb_noun, but the set remains predictable and readable.
Nine tools is well-scoped for an interactive exercise client: listing, navigation, reading, answering, visual interaction, and connection management each have a clear role. There is no obvious padding or missing major workflow category.
The surface covers the core lifecycle: launch/status, list books and exercises, open/read an exercise, fill answers, and use screenshot/click for interactive exercise types. Minor gaps exist around explicit submission/checking of answers or closing beook, but agents can likely work around these within the described workflow.