mcp-server-glitchtip by hffmnnj - MCP Server

mcp-server-glitchtip

MCP server enabling LLMs to query issues, stacktraces, and resolve errors in GlitchTip.

GlitchTip is an open-source, self-hosted error tracking platform that's API-compatible with Sentry. This MCP server lets AI assistants like Claude directly access your error data to help debug and fix issues faster.

Features

List Issues - Query all unresolved, resolved, or ignored issues
Get Issue Details - Retrieve full stacktraces and error context
Resolve Issues - Mark issues as resolved after fixing them

Installation

Using pip

pip install mcp-server-glitchtip

From source

git clone https://github.com/hffmnnj/mcp-server-glitchtip.git
cd mcp-server-glitchtip
pip install -e .

Configuration

1. Create a GlitchTip API Token

Go to your GlitchTip instance: https://your-glitchtip.com/settings/api-tokens
Click Create New Token
Copy the token

2. Find Your Organization and Project Slugs

Your organization slug is in the URL when viewing your organization:

https://your-glitchtip.com/organizations/{org-slug}/issues

Your project slug is visible in your project settings or URL:

https://your-glitchtip.com/organizations/{org-slug}/projects/{project-slug}

3. Add to Claude Code

claude mcp add mcp-server-glitchtip \
  -s user \
  -e GLITCHTIP_AUTH_TOKEN=your_token_here \
  -e GLITCHTIP_API_URL=https://your-glitchtip.com/api/0/ \
  -e GLITCHTIP_ORGANIZATION=your-org-slug \
  -e GLITCHTIP_PROJECT=your-project-slug \
  -- mcp-server-glitchtip

4. Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "glitchtip": {
      "command": "mcp-server-glitchtip",
      "env": {
        "GLITCHTIP_AUTH_TOKEN": "your_token_here",
        "GLITCHTIP_API_URL": "https://your-glitchtip.com/api/0/",
        "GLITCHTIP_ORGANIZATION": "your-org-slug",
        "GLITCHTIP_PROJECT": "your-project-slug"
      }
    }
  }
}

Environment Variables

Variable	Required	Description	Example
`GLITCHTIP_AUTH_TOKEN`	Yes	API token from GlitchTip	`abc123...`
`GLITCHTIP_API_URL`	Yes	Base API URL (include trailing slash)	`https://glitchtip.example.com/api/0/`
`GLITCHTIP_ORGANIZATION`	Yes	Organization slug	`my-org`
`GLITCHTIP_PROJECT`	Yes	Project slug	`my-app`

Available Tools

`get_glitchtip_issues`

List all issues from your GlitchTip project.

Parameters:

status (optional): Filter by status - unresolved, resolved, or ignored. Default: unresolved

Example response:

GlitchTip Issues (unresolved):

---
ID: 123 (PROJ-1)
Title: TypeError: Cannot read property 'foo' of undefined
Level: error | Count: 42
Culprit: app.js in handleClick
First: 2024-01-15T10:30:00Z | Last: 2024-01-15T14:22:00Z

`get_glitchtip_issue`

Get detailed information about a specific issue including the full stacktrace.

Parameters:

issue_id (required): The numeric issue ID

`resolve_glitchtip_issue`

Mark an issue as resolved after fixing the underlying bug.

Parameters:

issue_id (required): The numeric issue ID to resolve

Usage Examples

Once configured, you can ask Claude:

"Show me all unresolved errors in GlitchTip"
"What's the stacktrace for issue 123?"
"What errors are happening most frequently?"
"I fixed that null pointer bug, mark issue 456 as resolved"

Compatibility

This server works with any GlitchTip instance. GlitchTip uses a Sentry-compatible API, so the endpoints follow Sentry's API structure.

Tested with:

GlitchTip 3.x+
Python 3.10+

Development

# Clone the repo
git clone https://github.com/hffmnnj/mcp-server-glitchtip.git
cd mcp-server-glitchtip

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install in development mode
pip install -e .

# Run the server locally
GLITCHTIP_AUTH_TOKEN=xxx \
GLITCHTIP_API_URL=https://your-glitchtip.com/api/0/ \
GLITCHTIP_ORGANIZATION=your-org \
GLITCHTIP_PROJECT=your-project \
mcp-server-glitchtip

Related Projects

GlitchTip - Open source error tracking
MCP - Model Context Protocol
mcp-sentry - Similar MCP server for Sentry.io

License

MIT License - see for details.