Jira Scoped MCP Server

by deepwiredio.github.deepwired/mcp-jira-scopedv1.0.0

MCP server for Atlassian Jira built on scoped API tokens — server-side scope enforcement, configurable toolsets, project allowlisting, and Markdown/ADF fidelity

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active20d ago

Install Jira Scoped MCP server

claude mcp add jira-scoped -e JIRA_INSTANCE='<jira-instance>' -e JIRA_USER_EMAIL='<jira-user-email>' -e JIRA_API_TOKEN='<jira-api-token>' -- npx -y mcp-jira-scoped

{
  "mcpServers": {
    "jira-scoped": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-jira-scoped"
      ],
      "env": {
        "JIRA_INSTANCE": "<jira-instance>",
        "JIRA_USER_EMAIL": "<jira-user-email>",
        "JIRA_API_TOKEN": "<jira-api-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "jira-scoped": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-jira-scoped"
      ],
      "env": {
        "JIRA_INSTANCE": "<jira-instance>",
        "JIRA_USER_EMAIL": "<jira-user-email>",
        "JIRA_API_TOKEN": "<jira-api-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "jira-scoped": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-jira-scoped"
      ],
      "env": {
        "JIRA_INSTANCE": "<jira-instance>",
        "JIRA_USER_EMAIL": "<jira-user-email>",
        "JIRA_API_TOKEN": "<jira-api-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "jira-scoped": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-jira-scoped"
      ],
      "env": {
        "JIRA_INSTANCE": "<jira-instance>",
        "JIRA_USER_EMAIL": "<jira-user-email>",
        "JIRA_API_TOKEN": "<jira-api-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
JIRA_INSTANCE	yes	—	Jira instance name (e.g. 'mycompany' for mycompany.atlassian.net)
JIRA_USER_EMAIL	yes	—	Email associated with the API token
JIRA_API_TOKEN	yes	yes	Scoped API token from https://id.atlassian.com/manage-profile/security/api-tokens
JIRA_SCOPES	—	—	Comma-separated scopes: read:jira-work, write:jira-work, read:jira-user, read:me. Defaults to read:jira-work
JIRA_CLOUD_ID	—	—	Atlassian Cloud ID (auto-fetched if not set). Find at https://yoursite.atlassian.net/_edge/tenant_info

Freshness

Active — last maintenance signal 20d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-20 · 20d ago · GitHub
Latest release
2026-09-20 · 20d ago · GitHub · v2.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-03-28 · 7mo ago · official registry · v1.0.0

FAQ

›How do I install the Jira Scoped MCP server in Claude Code?

Run: claude mcp add jira-scoped -e JIRA_INSTANCE='<jira-instance>' -e JIRA_USER_EMAIL='<jira-user-email>' -e JIRA_API_TOKEN='<jira-api-token>' -- npx -y mcp-jira-scoped. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Jira Scoped require an API key?

Yes. It expects JIRA_INSTANCE, JIRA_USER_EMAIL, JIRA_API_TOKEN, of which 1 is a secret.

›Can I use Jira Scoped as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Jira Scoped in the official MCP registry?

Yes, as io.github.deepwired/mcp-jira-scoped.