# Geogebra MCP

> Geogebra MCP is an open-source MCP server for education and exams. Draw and edit plane-geometry figures live on GeoGebra Calculator (unofficial). It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/haison8x/geogebra-mcp
- **MCP Registry name:** io.github.haison8x/geogebra-mcp
- **Categories:** [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add geogebra-mcp -- npx -y geogebra-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "geogebra-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "geogebra-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Penline Handwriting Sheets](https://ai-powered.com/mcp/penline-handwriting-sheets): Penline Handwriting Sheets is an MCP server for education and exams.
- [Lumen](https://ai-powered.com/mcp/lumen-4): Lumen is an open-source MCP server for education and exams.
- [Education Mcp](https://ai-powered.com/mcp/education-mcp): Education Mcp is a freemium MCP server for education and exams.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [FreeDict](https://ai-powered.com/mcp/freedict): FreeDict is a freemium MCP server for language learning.
- [Extraudinary](https://ai-powered.com/mcp/extraudinary): Extraudinary is a freemium MCP server for education and exams.
- [Scormbusters](https://ai-powered.com/mcp/scormbusters): Scormbusters is an MCP server for education and exams.
- [Dengdeng Chinese Dictionary](https://ai-powered.com/mcp/dengdeng-chinese-dictionary): Dengdeng Chinese Dictionary is a free MCP server for language learning.

---
Source: https://ai-powered.com/mcp/geogebra-mcp
