stdio project-managementdev-tool

Jira MCP Server

Search and manage Jira issues, projects, and sprints via the Atlassian REST API.

Installation

npx -y mcp-atlassian

claude_desktop_config.json

{
  "mcpServers": {
    "server-jira": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Environment Variables

Variable Required Description
JIRA_URL ✓ Required Your Jira instance base URL.
JIRA_USERNAME ✓ Required Atlassian account email address.
JIRA_API_TOKEN ✓ Required Jira API token generated from id.atlassian.com/manage-profile/security/api-tokens.

Prerequisites

  • Node.js 18 or later
  • Required API keys — see the Environment Variables table above

Common Errors

  • Server not found / spawn error — ensure Node.js is on your PATH and the package is accessible via npx.
  • Permission denied — check that the path in args is readable by the process running your AI client.
  • Authentication failed — verify your API key is set correctly in the env block.

Related Servers