Geogebra Mcp

geogebra-mcp

An MCP server that lets an AI (Claude Desktop, Claude Code, Cursor, …) draw and edit plane-geometry figures directly on GeoGebra® Calculator (https://www.geogebra.org/calculator).

Unlike the copy/paste workflow of the GeoGebra AutoDraw AI extension, the AI here works in a loop: it runs commands, reads errors and the figure state, verifies properties, looks at a screenshot, and fixes the figure itself — and it can edit the figure on request ("H must be the foot from A").

[Demo: the AI builds triangle ABC inscribed in (O) with altitude AH and median AM, then A is dragged and the figure follows]

_{Made with GeoGebra® — https://www.geogebra.org}

Unofficial project, not affiliated with or endorsed by GeoGebra GmbH. See License & GeoGebra.

How it works

AI client ──MCP (stdio)──► geogebra-mcp ──Playwright──► Chrome window: geogebra.org/calculator                                                            └─ window.ggbApplet (GeoGebra JS API)

• On the first tool call the server opens a Chrome (or Edge) window on GeoGebra Calculator. The user watches the figure being drawn and can drag/edit it by hand.
• Tools call the GeoGebra JS API (ggbApplet) inside the page through page.evaluate — no simulated clicks.
• Commands run through asyncEvalCommandGetLabels, which lazy-loads GeoGebra modules, so prover/scripting commands (AreCollinear, Incircle, TriangleCenter, ClosestPoint(line, point)…) work.
• GeoGebra reports a failed command only as null, so the server adds its own diagnostics (unknown names, unknown commands, unbalanced brackets, known pitfalls) and warnings (undefined results, reserved names, two-point intersections without an index).
• If the window is closed or reloaded, the next tool call reopens it and restores the last known figure.
• Undo is managed by the server (XML history), because ggbApplet.undo() does not revert API commands.

Tools

Also: resource geogebra://rules (construction rules), resource geogebra://commands (command catalog), prompt draw_geometry_problem.

Setup

Requirements: Node.js ≥ 20 and Google Chrome or Microsoft Edge (otherwise run npx playwright install chromium).

Claude Code (plugin)

claude plugin marketplace add haison8x/geogebra-mcpclaude plugin install geogebra-mcp@geogebra-tools

The server then shows up in /mcp as plugin:geogebra-mcp:geogebra. Update later with claude plugin update geogebra-mcp@geogebra-tools.

Claude Code (without the plugin)

claude mcp add geogebra -- npx -y geogebra-mcp

Claude Desktop, Cursor and other MCP clients

Edit claude_desktop_config.json (Settings → Developer → Edit Config), or your client's MCP config:

{  "mcpServers": {    "geogebra": {      "command": "npx",      "args": ["-y", "geogebra-mcp"]    }  }}

Then restart the client and ask, for example: "Vẽ tam giác ABC nội tiếp đường tròn (O), đường cao AH, M là trung điểm BC."

From source

git clone https://github.com/haison8x/geogebra-mcp.gitcd geogebra-mcpnpm installnpm run buildclaude mcp add geogebra -- node /path/to/geogebra-mcp/dist/index.js

Configuration (environment variables)

Development

Releasing: bump the version in package.json, .claude-plugin/plugin.json, .claude-plugin/marketplace.json, server.json (both version fields) and the pinned version in .mcp.json. Then push, npm publish, mcp-publisher publish, and create a GitHub release.

npm run buildnpm run smoke              # end-to-end test through a real MCP client (headless)npm run smoke -- --headed  # same, with a visible window

Notes

• Snapshots and undo history live in memory while the server runs.

License & GeoGebra

• The code in this repository is MIT-licensed (LICENSE). That license does not cover GeoGebra.
• GeoGebra® is a registered trademark of GeoGebra GmbH. This project is independent and contains no GeoGebra software; it drives your own browser on geogebra.org, so your use of GeoGebra falls under the GeoGebra license.
• GeoGebra is free for non-commercial use. Commercial use (paid materials, training, services…) needs a license from GeoGebra ([email protected]).
• When you share figures, images or .ggb files made with this tool, keep the attribution "Made with GeoGebra®" with a link to https://www.geogebra.org.

See NOTICE for details.