English Français العربية

io.github.friendlygeorge/sentry-mcp-server

Official registry Archived Developer tools

MCP server for Sentry — error tracking, issues, releases, events, and projects for AI assistants.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package sentry-mcp-server
Claude Code 
claude mcp add sentry-mcp-server -e 'SENTRY_AUTH_TOKEN=<your sentry_auth_token>' -e 'SENTRY_BASE_URL=<SENTRY_BASE_URL>' -- npx -y sentry-mcp-server@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sentry-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "sentry-mcp-server@1.0.0"
            ],
            "env": {
                "SENTRY_AUTH_TOKEN": "<your sentry_auth_token>",
                "SENTRY_BASE_URL": "<SENTRY_BASE_URL>"
            }
        }
    }
}

Environment variables

  • SENTRY_AUTH_TOKEN required secret Sentry auth token from Settings → Auth Tokens. Needs org:read, project:read, event:read, issue:read, issue:write scopes.
  • SENTRY_BASE_URL Sentry API base URL. Defaults to https://sentry.io/api/0/. Override for self-hosted Sentry.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Sentry MCP Server
  2. Features
  3. Quick Start
  4. Environment Variables
  5. Example Queries
  6. API Coverage
  7. License

Sentry MCP Server

Connect AI assistants to Sentry — error tracking, issues, releases, events, and project management through the Model Context Protocol.

Works with Claude Desktop, Cursor, Windsurf, Cline, Continue, and any MCP-compatible client.

Features

ToolDescription
list_organizationsList all Sentry organizations you have access to
list_projectsList projects in an organization with slug, platform, and team info
list_issuesList issues with filters (environment, status, level, query, project)
get_issueGet full details of a specific issue — title, culprit, metadata, tags
list_issue_eventsList all events (occurrences) for a specific issue
get_eventGet full event details — exception, stacktrace, breadcrumbs, tags
list_releasesList releases in an organization with version, date, and authors
get_releaseGet details of a specific release with commit info and file changes
list_teamsList teams in an organization with member counts and slugs
list_membersList organization members with role and email
get_issue_hashesGet the grouping hashes (fingerprint) for an issue
update_issue_statusResolve, ignore, or unresolve an issue (and add a comment)

Quick Start

1. Get a Sentry Auth Token

Go to Sentry → Settings → Auth Tokens and create a token with the scopes you need (org:read, project:read, event:read, event:write, issue:read, issue:write).

Or visit: https://sentry.io/settings/auth-tokens/

2. Configure your MCP client

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "sentry-mcp-server"],
      "env": {
        "SENTRY_AUTH_TOKEN": "sntrys_YOUR_TOKEN_HERE"
      }
    }
  }
}

Cursor — add to MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["-y", "sentry-mcp-server"],
      "env": {
        "SENTRY_AUTH_TOKEN": "sntrys_YOUR_TOKEN_HERE"
      }
    }
  }
}
3. Run manually (for testing)
git clone https://github.com/friendlygeorge/sentry-mcp-server.git
cd sentry-mcp-server
npm install
npm run build

# Run
SENTRY_AUTH_TOKEN=sntrys_xxx node dist/index.js

Environment Variables

VariableRequiredDefaultDescription
SENTRY_AUTH_TOKEN✅—Your Sentry auth token (sntrys_...)
SENTRY_BASE_URL❌https://sentry.io/api/0/Sentry API base URL. Override for self-hosted Sentry.
Self-hosted Sentry

If you run your own Sentry instance, set SENTRY_BASE_URL:

SENTRY_BASE_URL=https://sentry.yourcompany.com/api/0/

Example Queries

"List my Sentry organizations"

"Show me unresolved errors in the production environment for org acme project web"

"Get details of issue 1234567890 and show me the latest event's stack trace"

"Resolve issue 1234567890 and add a comment that it's fixed in v1.2.3"

"List the last 10 releases for acme"

"Who are the members of acme org and their roles?"

API Coverage

This server covers the most-used endpoints of the Sentry Web API:

  • Organizations (/organizations/)
  • Projects (/organizations/{org}/projects/)
  • Issues (/organizations/{org}/issues/, /issues/{id}/)
  • Events (/issues/{id}/events/, /projects/{org}/{project}/events/{id}/)
  • Releases (/organizations/{org}/releases/)
  • Teams (/organizations/{org}/teams/)
  • Members (/organizations/{org}/members/)

For the full Sentry API, see docs.sentry.io/api.

License

MIT © 2026 Nova

Frequently asked questions

What is io.github.friendlygeorge/sentry-mcp-server?

MCP server for Sentry — error tracking, issues, releases, events, and projects for AI assistants.

How do I install io.github.friendlygeorge/sentry-mcp-server?

It runs on your machine. In Claude Code: claude mcp add sentry-mcp-server -e 'SENTRY_AUTH_TOKEN=<your sentry_auth_token>' -e 'SENTRY_BASE_URL=<SENTRY_BASE_URL>' -- npx -y sentry-mcp-server@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.friendlygeorge/sentry-mcp-server need an API key?

Yes. It expects SENTRY_AUTH_TOKEN, which you set in its configuration.

Is io.github.friendlygeorge/sentry-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.friendlygeorge/sentry-mcp-server?

It is published by friendlygeorge. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.