Skip to content
MCP server

Geogebra MCP

Draw and edit plane-geometry figures live on GeoGebra Calculator (unofficial)

Runs locallyStatus and history
Install
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "geogebra-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "geogebra-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "geogebra-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "geogebra-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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 window
  • GGB_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.

How AIPoweredBot checks servers