gel-mcp

Model Context Protocol server that provides access to Gel

3 stars PythonOthers Updated Feb 6, 2026

Documentation

Gel MCP server

This MCP server provides tools and resources that help coding agents use the Gel database.

Available tools

1. `execute_query`: run a query against the Gel instance configured in the current project. Supports arguments and globals.

2. `try_query`: run a query in a transaction that gets rolled back in the end, preventing actual data modification.

3. `list_examples` and `fetch_example`: access code examples for advanced workflows such as configuring the AI extension.

4. `list_rules` and `fetch_rule`: in case you forgot to configure Gel rules in your text editor, the agent can access them like this, too.

Install

If at any point you get lost, refer to this repository to see an example config layout for your editor.

Cursor

1. Add the following to `.cursor/mcp.json`:

json

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

2. Open MCP settings, e.g. via Command Palette: `View: Open MCP Settings` and toggle Gel in there.

Claude Code

Add the following to `.mcp.json`:

json

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

VSCode with Copilot

Add the following to `.vscode/mcp.json`:

json

{
  "servers": {
    "gel": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

Windsurf

Follow Windsurf Cascade's documentation to open global `mcp_config.json` via the clicky interface.

Add the following:

json

{
  "mcpServers": {
    "gel": {
      "command": "uvx",
      "args": [
        "--refresh",
        "--python",
        "3.13",
        "--directory",
        ".",
        "--from",
        "git+https://github.com/geldata/gel-mcp.git",
        "gel-mcp"
      ]
    }
  }
}

Zed

Add the following to `.zed/settings.json`:

json

{
  "context_servers": {
    "gel": {
      "source": "custom",
      "command": {
        "path": "uvx",
        "args": [
          "--refresh",
          "--python",
          "3.13",
          "--directory",
          ".",
          "--from",
          "git+https://github.com/geldata/gel-mcp.git",
          "gel-mcp"
        ],
        "env": {}
      }
    }
  }
}

Develop

Clone the repository and create the virtual environment:

bash

uv sync

Open the server in the MCP Inspector:

bash

mcp dev src/gel_mcp/server.py

Frequently asked questions

What is gel-mcp?

gel-mcp is Model Context Protocol server that provides access to Gel

How do I install gel-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is gel-mcp open source?

Yes — it is hosted on GitHub at https://github.com/geldata/gel-mcp and has 3 stars.

Related MCP tools

cognee

Cognee is the open-source AI memory platform for agents. Give your AI agents persistent long-term memory across sessions with a self-hosted knowledge graph engine.

30,433 Python

agent-memoryagent-skillsai+16

skyvern

Automate browser based workflows with AI

22,930 Python

apiautomationbrowser+13

hindsight

Hindsight: Agent Memory That Learns

22,468 Python

agentic-aimemoryagents+1

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

20,504 Python

agent-skillaic2pa+12

Qwen-Agent

Agent framework and applications built upon Qwen>=3.0, featuring Function Calling, MCP, Code Interpreter, RAG, Chrome extension, etc.

17,062 Python

pal-mcp-server

The power of Claude Code / GeminiCLI / CodexCLI + [Gemini / OpenAI / OpenRouter / Azure / Grok / Ollama / Custom Model / All Of The Above] working as one.

11,731 Python

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP