MCP Server — deepwired/mcp-jira

Jira MCP server with scoped API tokens via api.atlassian.com gateway

Local serverstdioGo

What is the MCP Server?

Jira MCP server with scoped API tokens via api.atlassian.com gateway

What you get

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.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
readjira-work — read issues, search, comments, projects
writejira-work — create/update/delete issues, add comments
jira_get_issueGet issue by key. Pass includeCustomFields: true to return all custom fields
jira_searchSearch issues via JQL with pagination
jira_list_commentsList comments on an issue
jira_list_projectsList accessible projects
jira_get_projectGet project details by key
jira_list_link_typesList available issue link types
jira_list_fieldsList all fields (system + custom) — discover customfield_* IDs
jira_list_attachmentsList attachments on an issue with filename, size, MIME type, and download URL
jira_get_transitionsGet available transitions for an issue with required screen fields expanded
jira_create_issueCreate an issue (task, bug, story, epic). Supports custom fields
jira_update_issueUpdate fields on an issue. Supports custom fields
jira_add_commentAdd a comment (plain text auto-converted to ADF)

How to install the MCP Server

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "mcp-jira-scoped"],
      "env": {
        "JIRA_INSTANCE": "yourcompany",
        "JIRA_USER_EMAIL": "you@yourcompany.com",
        "JIRA_API_TOKEN": "<your-scoped-token>",
        "JIRA_SCOPES": "read:jira-work,write:jira-work"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
JIRA_INSTANCEConfiguration value read at startup.Optional
JIRA_USER_EMAILConfiguration value read at startup.Optional
JIRA_API_TOKENCredential the server authenticates with.Yes
JIRA_SCOPESConfiguration value read at startup.Optional
JIRA_CLOUD_IDConfiguration value read at startup.Optional

Example prompts to try

  • “Use MCP to read.”
  • “Use MCP to write.”
  • “Use MCP to jira get issue.”

Frequently asked questions

Jira MCP server with scoped API tokens via api.atlassian.com gateway Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.