Sentry MCP Server

Also available in Russian: README-ru.md

Sentry MCP server provides tools for working with Sentry organizations, projects, and issues directly from Claude Code, Code CLI, and other MCP clients.

Table of Contents

• Features

• Requirements

• Installation

  • Using npx (Recommended)

  • Manual Installation (Development)

• Running the server (stdio)

• Configuration for Code (Recommended)

• Configuration for Claude Code CLI

• Configuration for VS Code Cline

• MCP Tools

Related MCP server: Sentry MCP Server

Features

• List organizations and projects available to the token.

• Query issues with filters: query, multiple environment, statsPeriod or since/until, project, pagination via cursor.

• Consistent structured responses with toolSuccess/toolError.

Requirements

• Node.js 20+

• Environment variables:

  • SENTRY_URL — Sentry base URL

  • SENTRY_TOKEN — Sentry auth token (Bearer)

  • SENTRY_TIMEZONE — optional, defaults to Europe/Moscow

  • SENTRY_READ_ONLY — optional, defaults to true

  • SENTRY_HTTP_TIMEOUT_MS — optional request timeout in ms (default 10000)

Installation

Using npx (Recommended)

npx -y @vitalyostanin/sentry-mcp@latest

Manual Installation (Development)

npm ci
npm run build

Running the server (stdio)

node dist/index.js

Configuration for Code (Recommended)

Add to ~/.code/config.toml:

[mcp_servers.sentry-mcp]
command = "npx"
args = ["-y", "@vitalyostanin/sentry-mcp@latest"]

[mcp_servers.sentry-mcp.env]
SENTRY_URL = "https://sentry.example.com"
SENTRY_TOKEN = "<token>"

Configuration for Claude Code CLI

{
  "mcpServers": {
    "sentry-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/sentry-mcp@latest"],
      "env": {
        "SENTRY_URL": "https://sentry.example.com",
        "SENTRY_TOKEN": "<token>"
      }
    }
  }
}

Configuration for VS Code Cline

Add similar entry to your cline_mcp_settings.json:

{
  "mcpServers": {
    "sentry-mcp": {
      "command": "npx",
      "args": ["-y", "@vitalyostanin/sentry-mcp@latest"],
      "env": {
        "SENTRY_URL": "https://sentry.example.com",
        "SENTRY_TOKEN": "<token>"
      }
    }
  }
}

MCP Tools