Jira Scoped MCP Server

The only MCP server for Jira that works with Atlassian's scoped API tokens. Every other Jira MCP server uses classic (unscoped) API tokens with basic auth against yoursite.atlassian.net. Atlassian is deprecating those. This server uses scoped tokens with the modern api.atlassian.com gateway - the way Atlassian intends these tokens to be used. Its 19 documented tools cover jira, issue, attachment.

People connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-04-01 · ★ 3 · #102 OF 139 MAINTAINED PRODUCTIVITY · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Jira Scoped

before you install - you'll need

Set JIRA_INSTANCE, JIRA_USER_EMAIL, JIRA_API_TOKEN before connecting. JIRA_SCOPES is optional or environment-specific per the README.

Claude Code

claude mcp add deepwired-mcp-jira -- npx -y mcp-jira-scoped

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "deepwired-mcp-jira": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-jira-scoped"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package mcp-jira-scoped - unscoped; check the name against the project README before installing

registry namespace io.github.deepwired is GitHub-verified and matches the repo owner

03 · What Jira Scoped can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get issue by key. Pass includeCustomFields: true to return all custom fields, search issues via JQL with pagination, list comments on an issue, and list accessible projects.

The 19 tools it gives your agent

Extracted from the project's README - what mcp-jira-scoped lets an agent do.

jira_get_issue: - Get issue by key. Pass includeCustomFields: true to return all custom fields
jira_search: - Search issues via JQL with pagination
jira_list_comments: - List comments on an issue
jira_list_projects: - List accessible projects
jira_get_project: - Get project details by key
jira_list_link_types: - List available issue link types
jira_list_fields: - List all fields (system + custom) - discover customfield_ IDs
jira_list_attachments: - List attachments on an issue with filename, size, MIME type, and download URL
jira_get_transitions: - Get available transitions for an issue with required screen fields expanded
jira_create_issue: - Create an issue (task, bug, story, epic). Supports custom fields
jira_update_issue: - Update fields on an issue. Supports custom fields
jira_add_comment: - Add a comment (plain text auto-converted to ADF)

show all 19 tools

jira_transition_issue: - Move an issue to a new status. Accepts fields and comment for transition screens
jira_delete_issue: - Delete an issue (requires confirm: true safety guard)
jira_link_issues: - Link two issues (blocks, relates, split, clone, etc.)
jira_add_attachment: - Upload a local file as an attachment to an issue
jira_delete_attachment: - Delete an attachment by ID (requires confirm: true safety guard)
jira_get_user: - Get user info by account ID
jira_search_users: - Search users by name or email

Limitations (from the README)

The GitHub repo is mcp-jira but the npm package is mcp-jira-scoped. We plan to unify under mcp-jira in a future release. For now, use npx -y mcp-jira-scoped to run the server.

04 · Who maintains Jira Scoped

mcp-jira-scoped is maintained by deepwired. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository: github.com/deepwired/mcp-jira
category: productivity - ranked #102 of 139 actively-maintained productivity servers as of 2026-08-25.
registry: io.github.deepwired/mcp-jira-scoped (active, first published 2026-03-28)
packages: npm:mcp-jira-scoped

06 · Jira Scoped FAQ

Is Jira Scoped still maintained?

Yes - as of 2026-08-25, its last commit was 2026-04-01. We re-verify nightly.

What can Jira Scoped do?

How do I install Jira Scoped?

Run `npx -y mcp-jira-scoped`. The README documents 4 environment variables (JIRA_INSTANCE, JIRA_USER_EMAIL, JIRA_API_TOKEN…) to set first. Set JIRA_INSTANCE, JIRA_USER_EMAIL, JIRA_API_TOKEN before connecting. JIRA_SCOPES is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Jira Scoped run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Jira Scoped

Alternatives to Jira Scoped

Maintained productivity servers if Jira Scoped isn't the fit.

Pairs well with

Servers that cover what Jira Scoped doesn't - only shown when the pairing reason fits the companion.

More productivity MCP servers · Server Trello · Focus Relay · Airtable · Caldav MCP

More TypeScript MCP servers · DDC/CI Control Bridge · DataDoe MCP · Polymarket Agent MCP · Deployhq MCP Server · see all