Jira Scoped MCP Server

A Jira MCP server built around Atlassian's scoped API tokens, with scope enforcement in the server itself. Its 40 documented tools cover jira, issue, comment, attachment. It runs locally over stdio via the published package.

People who work with jira, issue and comment and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-20 · ★ 4 · #64 OF 169 MAINTAINED PRODUCTIVITY · VERIFIED 2026-09-30

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, JIRA_PROJECTS before connecting. JIRA_SCOPES, JIRA_TOOLSETS are 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 an issue by key. includeCustomFields: true returns all custom fields, list comments with IDs, authors and timestamps, list accessible projects, and create an issue, with custom field support.

The 40 tools it gives your agent

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

jira_get_issue
- Get an issue by key. includeCustomFields: true returns all custom fields
jira_search
- JQL search, paginated with nextPageToken. includeTotal adds an approximate count
jira_list_comments
- List comments with IDs, authors and timestamps
jira_list_projects
- List accessible projects
jira_get_project
- Project details by key
jira_list_fields
- All fields including custom - discover customfield_ IDs
jira_get_transitions
- Available transitions with their required screen fields
jira_create_issue
- Create an issue, with custom field support
jira_update_issue
- Update fields. Omit a field to leave it; pass null to clear it
jira_assign_issue
- Assign, or unassign with accountId: null
jira_transition_issue
- Move to a new status, with optional fields and comment
jira_delete_issue
- Delete an issue (confirm: true)
show all 40 tools
jira_add_comment
- Add a comment (Markdown by default)
jira_update_comment
- Edit an existing comment
jira_delete_comment
- Delete a comment (confirm: true)
jira_get_myself
- The authenticated account. Resolves "me", and the cheapest connection check
jira_get_user
- User info by account ID
jira_search_users
- Find users by name or email
jira_list_attachments
- Filename, size, MIME type, uploader, download URL
jira_add_attachment
- Upload a local file
jira_download_attachment
- Download to a local path
jira_delete_attachment
- Delete by ID (confirm: true)
jira_list_link_types
- Available link types (Blocks, Relates, Cloners…)
jira_link_issues
- Link two issues
jira_remove_link
- Remove an issue link (confirm: true)
jira_list_remote_links
- External URLs attached to an issue
jira_create_remote_link
- Attach an external URL (Confluence page, PR, doc)
jira_delete_remote_link
- Remove one (confirm: true)
jira_list_worklogs
- Entries with author, time and comment, plus the total shown
jira_add_worklog
- Log work ("2h", "1d 4h")
jira_update_worklog
- Change time, start or comment
jira_delete_worklog
- Delete an entry (confirm: true)
jira_get_create_meta
- What's required to create an issue here. Lists issue types, then the required fields and their allowed values
jira_get_changelog
- Change history, optionally filtered to one field
jira_list_boards
- Boards, optionally filtered by project
jira_list_sprints
- Sprints on a board, filterable by state
jira_get_sprint_issues
- Issues in a sprint, with optional extra JQL
jira_manage_sprint
- Create, update (including start/close) or move issues into a sprint
jira_list_versions
- Project versions with release state
jira_manage_version
- Create, update or release a version

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.

Latest releases

v2.0.0 · 2026-09-20

See CHANGELOG.md

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

category
productivity - ranked #64 of 169 actively-maintained productivity servers as of 2026-09-30.
release cadence
1 release in the last 90 days (latest 2026-09-20)
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-09-30, its last commit was 2026-09-20 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Jira Scoped do?

With this server connected, an agent can get an issue by key. includeCustomFields: true returns all custom fields, list comments with IDs, authors and timestamps, list accessible projects, and create an issue, with custom field support.

How do I install Jira Scoped?

Run `npx -y mcp-jira-scoped`. The README documents 6 environment variables (JIRA_INSTANCE, JIRA_USER_EMAIL, JIRA_API_TOKEN…) to set first. Set JIRA_INSTANCE, JIRA_USER_EMAIL, JIRA_API_TOKEN, JIRA_PROJECTS before connecting. JIRA_SCOPES, JIRA_TOOLSETS are 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