Installation

Prerequisites

Node.js v18 or higher
Jira instance (Cloud or Server)
Jira API token

Quick Install (Claude Code)

The fastest way to add this MCP server:

claude mcp add jira npx mcp-jira-stdio@latest \
  --env JIRA_BASE_URL=https://yourcompany.atlassian.net \
  --env JIRA_EMAIL=your-email@example.com \
  --env JIRA_API_TOKEN=your-api-token

npm Installation

# Install globally
npm install -g mcp-jira-stdio

# Or install locally
npm install mcp-jira-stdio

Development Installation

# Clone the repository
git clone https://github.com/freema/mcp-jira-stdio.git
cd mcp-jira-stdio

# Install dependencies
npm install

# Build the project
npm run build

Jira API Setup

Go to your Jira instance settings
Create an API token:
- Jira Cloud: Go to Account Settings -> Security -> Create and manage API tokens
- Jira Server: Use your username and password (or create an application password)
Note your Jira base URL (e.g., https://yourcompany.atlassian.net)

Generate your API token at https://id.atlassian.com/manage-profile/security/api-tokens

Claude Desktop Configuration

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["mcp-jira-stdio"],
      "env": {
        "JIRA_BASE_URL": "https://your-instance.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Restart Claude Desktop after adding the configuration.

Verify Installation

Test your Jira connection:

# Test connection
task jira:test

# List visible projects
task jira:projects

Installation

On this page