sentry-mcp-server

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

Tool	Description
list_organizations	List all Sentry organizations you have access to
list_projects	List projects in an organization with slug, platform, and team info
list_issues	List issues with filters (environment, status, level, query, project)
get_issue	Get full details of a specific issue — title, culprit, metadata, tags
list_issue_events	List all events (occurrences) for a specific issue
get_event	Get full event details — exception, stacktrace, breadcrumbs, tags
list_releases	List releases in an organization with version, date, and authors
get_release	Get details of a specific release with commit info and file changes
list_teams	List teams in an organization with member counts and slugs
list_members	List organization members with role and email
get_issue_hashes	Get the grouping hashes (fingerprint) for an issue
update_issue_status	Resolve, 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

Variable	Required	Default	Description
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