Geogebra MCP

What haison8x/geogebra-mcp does

haison8x/geogebra-mcp lets an MCP-compatible AI client create and edit plane-geometry figures in GeoGebra Calculator. It is intended for workflows where an agent needs more than one-way command submission: the agent can construct a figure, read the resulting objects, check geometric conditions, inspect an image, and make corrections.

The project drives GeoGebra at https://www.geogebra.org/calculator rather than embedding GeoGebra software. It is an independent project and is not affiliated with or endorsed by GeoGebra GmbH. GeoGebra’s own licensing terms apply to use of the service and to figures created with it.

How it works

The first tool call opens a Chrome or Edge window containing GeoGebra Calculator. The user can watch the construction and interact with the figure manually. Playwright evaluates calls to GeoGebra’s ggbApplet JavaScript API inside the page, avoiding simulated mouse clicks.

Commands are sent through GeoGebra’s asynchronous command interface. The server adds diagnostics around GeoGebra’s results, including hints for unknown names or commands, unbalanced brackets, undefined results, reserved names, and ambiguous two-point intersections. If the page is closed or reloaded, a later tool call reopens it and restores the last known figure. Server-managed XML history provides undo for API changes.

The server also exposes the geogebra://rules and geogebra://commands resources, along with a draw_geometry_problem prompt.

Setup and configuration

Use Node.js 20 or newer and Google Chrome or Microsoft Edge. If neither browser is available, install Playwright’s Chromium build with npx playwright install chromium.

A package-based MCP configuration can launch the server with:

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

Claude Code can install the project as a plugin or register it with claude mcp add geogebra -- npx -y geogebra-mcp. From source, clone the repository, run npm install and npm run build, then point the MCP client at dist/index.js.

Configuration variables include GGB_BROWSER, which selects Chrome, Edge, or Playwright Chromium; GGB_HEADLESS, which enables headless mode with 1; GGB_PROFILE_DIR, which controls the persistent browser profile; and GGB_URL, which sets the page opened by the server. The default profile preserves the GeoGebra login, and each profile supports one server instance.

Tools and capabilities

• ggb_run_commands executes ordered GeoGebra commands and reports results, created or removed objects, warnings, and failure hints. Assigning an existing name redefines that object.
• ggb_get_state returns object types, definitions, values, coordinates, visibility, and dependency relationships.
• ggb_evaluate checks expressions without creating objects, including angle and collinearity tests.
• ggb_screenshot captures the drawing area or the complete window as a PNG.
• ggb_set_style changes appearance properties such as color, labels, captions, visibility, line style, thickness, point size, fill, and fixed status.
• ggb_delete, ggb_clear, and ggb_undo remove objects, start a new figure, or revert server-managed changes.
• ggb_snapshot saves, restores, and lists named in-memory versions.
• ggb_fit_view frames visible points and circles, maintains a 1:1 ratio, and controls axes and grid display.
• ggb_export saves figures as .ggb or .png files.

Limitations and notes

Snapshots and undo history exist only in memory while the server is running. The code is MIT-licensed, but that license does not cover GeoGebra. GeoGebra is free for non-commercial use; commercial uses such as paid materials, training, or services require a GeoGebra license. Shared figures, images, and .ggb files should retain the attribution “Made with GeoGebra®” and a link to https://www.geogebra.org.