Sentry MCP server

Q: How do I add Sentry MCP to Claude Code?

Run `claude mcp add --env SENTRY_AUTH_TOKEN= sentry-mcp -- npx -y @sentry/mcp-server` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add Sentry MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ Official ✓ VerifiedCommit Nov 14, 2026

getsentry/sentry-mcp · typescript

Enables AI assistants to monitor errors, track issues, and perform debugging using Sentry data.

Also known as getsentry/toolkit, sentry-mcp, @sentry/mcp-server

stdio remote Monitoring & Observability Developer Tools

Install GitHub ↗

Stars: 963
Tools: —
Downloads, 30 days: —
Latest version: 0.49.0
Last commit: Nov 14, 2026
License: —

What is Sentry MCP?

Sentry enables AI assistants to monitor errors, track issues, and perform debugging using Sentry data.

Summary generated from the project's README

About Sentry MCP server

Monitoring application errors and debugging issues directly through an AI assistant is possible with this Sentry MCP server. It allows developers to access Sentry data to track issues and investigate bugs within their chat interface. The server works with both sentry.io and self-hosted Sentry instances by configuring the SENTRY_HOST or SENTRY_URL environment variables.

Users can set up the server using npx or by using the Sentry CLI via the sentry mcp command. Authentication is handled through a single sign-in process using sentry auth login, which shares credentials with the CLI, or by providing a SENTRY_AUTH_TOKEN in the client environment. This setup requires Node.js 22.15 or later for clients running the package through npx.

This tool is unique because it integrates deeply with the Sentry CLI, allowing for shared authentication and management of account status, switching, or logging out. It also includes utility commands like cli defaults and cli fix to manage corporate TLS proxies or repair local databases.

What you can do with it

1Connecting to self-hosted instancesDirect an AI client to communicate with a private Sentry deployment using specific host settings.
2Configuring corporate network settingsSet up CA certificates for environments using a corporate TLS proxy.

Written from the project's README. Every use case is checked against a quote from it.

How to install Sentry MCP

Formats verified 10 Nov 2026

Claude CodeCursorVS CodeClaude DesktopCodexGemini CLI

$ claude mcp add --env SENTRY_AUTH_TOKEN=<YOUR_SENTRY_AUTH_TOKEN> sentry-mcp -- npx -y @sentry/mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "sentry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ],
      "env": {
        "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "sentry-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ],
      "env": {
        "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "sentry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ],
      "env": {
        "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>"
      }
    }
  }
}

~/.codex/config.toml

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

[mcp_servers.sentry-mcp.env]
SENTRY_AUTH_TOKEN = "<YOUR_SENTRY_AUTH_TOKEN>"

~/.gemini/settings.json

{
  "mcpServers": {
    "sentry-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ],
      "env": {
        "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>"
      }
    }
  }
}

Set 3 environment variables before starting the server (below).Setup guides:Claude Code Cursor VS Code Claude Desktop

Configuration

SENTRY_AUTH_TOKENSecret
Sentry auth token. Optional after `npx -y @sentry/mcp-server auth login`.
SENTRY_HOST
Self-hosted Sentry hostname or URL. Takes precedence over SENTRY_URL. Defaults to sentry.io.
SENTRY_URL
Self-hosted Sentry URL, such as https://sentry.example.com. Defaults to sentry.io.

Name	Description
SENTRY_AUTH_TOKEN	Sentry auth token. Optional after `npx -y @sentry/mcp-server auth login`.	Secret
SENTRY_HOST	Self-hosted Sentry hostname or URL. Takes precedence over SENTRY_URL. Defaults to sentry.io.
SENTRY_URL	Self-hosted Sentry URL, such as https://sentry.example.com. Defaults to sentry.io.

Automated checks

Ran Nov 12, 2026Full report →

89/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)No licenseFinding
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSPass
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesPass

README

View on GitHub

@sentry/mcp-server

The Sentry MCP server for stdio clients, as a single file with no runtime dependencies. Works with sentry.io and self-hosted Sentry.

Prefer sentry mcp. The Sentry CLI runs the same server as sentry mcp, using your CLI login, so the MCP config needs no token:
curl https://cli.sentry.dev/install -fsS | bash
sentry auth login
claude mcp add sentry -- sentry mcp
Other clients take {"command": "sentry", "args": ["mcp"]}. See the sentry mcp docs and https://mcp.sentry.dev/?transport=cli. This package remains for clients that launch the server through npx.

{
  "command": "npx",
  "args": ["-y", "@sentry/mcp-server@latest"]
}

Requires Node.js 22.15 or later.

Authentication

npx -y @sentry/mcp-server auth login signs in once. The login is shared with the sentry CLI, so an existing sentry auth login works too.

To use a token instead, set SENTRY_AUTH_TOKEN in the client's env. It wins over a stored login:

{
  "command": "npx",
  "args": ["-y", "@sentry/mcp-server@latest"],
  "env": {
    "SENTRY_AUTH_TOKEN": "sntryu_..."
  }
}

--access-token / SENTRY_ACCESS_TOKEN are deprecated. They still work, as SENTRY_AUTH_TOKEN, and print a warning on stderr.
Each server process uses one account. The package runs the CLI's own auth commands, so npx -y @sentry/mcp-server auth status|list|switch|logout manages the same login.
npx -y @sentry/mcp-server cli defaults and cli fix are the CLI's own commands too: they set the defaults (such as ca-cert for a corporate TLS proxy) and repair the local database the server shares with the CLI.

Options

Starting the server is the default command, so npx -y @sentry/mcp-server and npx -y @sentry/mcp-server mcp are the same. Run npx -y @sentry/mcp-server mcp --help for the flags and environment variables. For self-hosted Sentry, set SENTRY_HOST / SENTRY_URL (with SENTRY_AUTH_TOKEN, only these scope the token to your server). See stdio authentication.

Development

The source lives in packages/cli: packages/cli/src/mcp-server.ts runs the CLI's runner with an application of four commands, mcp, auth, cli (defaults and fix only), and help (packages/cli/src/mcp-server-app.ts). pnpm run bundle builds dist/sentry-mcp.cjs from it, and pnpm run test:bundle smoke-tests the result.

Read full README

Sentry MCP questions

How do I add Sentry MCP to Claude Code?

Run claude mcp add --env SENTRY_AUTH_TOKEN=<YOUR_SENTRY_AUTH_TOKEN> sentry-mcp -- npx -y @sentry/mcp-server in your terminal. Add --scope user to make it available in every project.

How do I add Sentry MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What are the Node.js requirements?

The server requires Node.js version 22.15 or later.

Facts

Nov 14, 2026

Stars: 963
Downloads, 30 days: —
Latest version: 0.49.0
Last commit: Nov 14, 2026
License: —
Transport: stdio, remote
Package: @sentry/mcp-server

getsentry ↗

Official publisher

Published by the company that makes the product.

Alternatives

Skills for Sentry

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/getsentry/sentry-mcp.svg)](https://hostedmcp.org/servers/getsentry/sentry-mcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

About Sentry MCP server

What you can do with it

1Connecting to self-hosted instancesDirect an AI client to communicate with a private Sentry deployment using specific host settings.
2Configuring corporate network settingsSet up CA certificates for environments using a corporate TLS proxy.

Written from the project's README. Every use case is checked against a quote from it.

{ "mcpServers": { "sentry-mcp": { "command": "npx", "args": [ "-y", "@sentry/mcp-server" ], "env": { "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>" } } } }

{ "servers": { "sentry-mcp": { "type": "stdio", "command": "npx", "args": [ "-y", "@sentry/mcp-server" ], "env": { "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>" } } } }

{ "mcpServers": { "sentry-mcp": { "command": "npx", "args": [ "-y", "@sentry/mcp-server" ], "env": { "SENTRY_AUTH_TOKEN": "<YOUR_SENTRY_AUTH_TOKEN>" } } } }

Configuration

SENTRY_AUTH_TOKENSecret

Sentry auth token. Optional after `npx -y @sentry/mcp-server auth login`.

SENTRY_HOST

Self-hosted Sentry hostname or URL. Takes precedence over SENTRY_URL. Defaults to sentry.io.

SENTRY_URL

Self-hosted Sentry URL, such as https://sentry.example.com. Defaults to sentry.io.

Name	Description
SENTRY_AUTH_TOKEN	Sentry auth token. Optional after `npx -y @sentry/mcp-server auth login`.	Secret
SENTRY_HOST	Self-hosted Sentry hostname or URL. Takes precedence over SENTRY_URL. Defaults to sentry.io.
SENTRY_URL	Self-hosted Sentry URL, such as https://sentry.example.com. Defaults to sentry.io.

Sentry MCP questions

How do I add Sentry MCP to Claude Code?

Run claude mcp add --env SENTRY_AUTH_TOKEN=<YOUR_SENTRY_AUTH_TOKEN> sentry-mcp -- npx -y @sentry/mcp-server in your terminal. Add --scope user to make it available in every project.

How do I add Sentry MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What are the Node.js requirements?

The server requires Node.js version 22.15 or later.

Sentry MCP server

What is Sentry MCP?

About Sentry MCP server

What you can do with it

How to install Sentry MCP

Install Sentry MCP in Claude Code

Install Sentry MCP in Cursor

Install Sentry MCP in VS Code

Install Sentry MCP in Claude Desktop

Install Sentry MCP in Codex

Install Sentry MCP in Gemini CLI

Configuration

Automated checks

README

@sentry/mcp-server

Authentication

Options

Development

Sentry MCP questions

Sentry MCP server

What is Sentry MCP?

About Sentry MCP server

What you can do with it

How to install Sentry MCP

Install Sentry MCP in Claude Code

Install Sentry MCP in Cursor

Install Sentry MCP in VS Code

Install Sentry MCP in Claude Desktop

Install Sentry MCP in Codex

Install Sentry MCP in Gemini CLI

Configuration

Automated checks

README

@sentry/mcp-server

Authentication

Options

Development

Sentry MCP questions