Geogebra MCP
Draw and edit plane-geometry figures live on GeoGebra Calculator (unofficial)
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.1.2
- Listing updated
- today
Similar MCP servers
About Geogebra MCP
Geogebra MCP is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.
Instead of pasting GeoGebra commands by hand, this server lets the assistant work in a loop inside a real browser window: it runs commands, reads errors and the figure state, takes a screenshot, checks properties and fixes the figure itself. The user can watch and drag objects while it draws.
It uses Playwright to open geogebra.org/calculator in Chrome or Edge and calls the page's JavaScript API directly, not simulated clicks. GeoGebra reports failures only as null, so the server adds its own diagnostics for unknown names, unbalanced brackets and undefined results. Undo is handled by the server, and a closed window is reopened with the last figure restored.
It is unofficial and not affiliated with GeoGebra GmbH. The code is MIT-licensed, but GeoGebra is free only for non-commercial use, and shared figures should carry the Made with GeoGebra attribution.
Install
Run in a terminal
claude mcp add geogebra-mcp -- npx -y geogebra-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"geogebra-mcp": {
"command": "npx",
"args": [
"-y",
"geogebra-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"geogebra-mcp": {
"command": "npx",
"args": [
"-y",
"geogebra-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"geogebra-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"geogebra-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"geogebra-mcp": {
"command": "npx",
"args": [
"-y",
"geogebra-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"geogebra-mcp": {
"command": "npx",
"args": [
"-y",
"geogebra-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GGB_BROWSERBrowser channel: chrome or msedge (default: try chrome, msedge, then Playwright Chromium)GGB_HEADLESSSet to 1 to run without a visible windowGGB_PROFILE_DIRBrowser profile directory (default: ~/.geogebra-mcp/profile)GGB_URLPage to open
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- ggb_run_commands
- Run commands in order with per-command results and warnings.
- ggb_get_state
- Objects with type, definition, value, coordinates and dependencies.
- ggb_screenshot
- PNG of the drawing area or whole window.
- ggb_evaluate
- Evaluate expressions without adding objects.
- ggb_set_style
- Set colour, visibility, label, thickness, line style and fill.
- ggb_delete
- Delete objects and their dependents.
- ggb_clear
- Start a new figure.
- ggb_undo
- Revert changes made through the server.
- ggb_snapshot
- Save, restore or list named versions.
- ggb_fit_view
- Fit visible points and circles in view.
- ggb_export
- Save as .ggb or .png.
What it does
- Command loop
- Runs GeoGebra commands in order with per-command results and failure hints.
- State inspection
- Lists objects with definitions, values and dependencies.
- Screenshots
- Returns a PNG of the drawing area for visual checks.
- Named snapshots
- Save, restore and list versions of a figure.
- Styling and view
- Set colours, labels, thickness and fit the view.
- Export
- Save the figure as .ggb or .png.
Good for
- Construct a triangle with its circumcircle and altitude
- Verify a geometric property such as collinearity
- Edit a figure on request, for example moving a foot of an altitude
- Export a diagram for a worksheet
Pricing
Open source
MIT-licensed; GeoGebra itself is free for non-commercial use only
Geogebra MCP FAQ
Is it official?
No; it is unofficial and not affiliated with GeoGebra GmbH.
What do I need?
Node.js 20 or later and Chrome or Edge, or Playwright Chromium.
Can I use it commercially?
The README notes GeoGebra is free for non-commercial use and commercial use needs a GeoGebra licence.
Does undo work?
The server manages its own undo history, kept in memory while it runs.
Is Geogebra MCP free?
Yes. Geogebra MCP is open source, so you can use and self-host it for free.
How do I add Geogebra MCP to Claude Code?
Run this command in your terminal: claude mcp add geogebra-mcp -- npx -y geogebra-mcp
What are the best alternatives to Geogebra MCP?
The closest alternatives to Geogebra MCP are Penline Handwriting Sheets, Lumen, Education Mcp, Born Then and FreeDict.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.