jiri-mcp — Jira MCP Server

An MCP (Model Context Protocol) server that connects AI agents to Jira Cloud, enabling natural language issue management.

Features

Related MCP server: Jira Extended MCP Server

Setup

1. Install dependencies

npm install

2. Configure environment

Copy the example env file and fill in your credentials:

cp .env.example .env

You'll need:

• JIRA_HOST — Your Jira Cloud URL (e.g., https://yourcompany.atlassian.net)

• JIRA_EMAIL — Your Atlassian account email

• JIRA_API_TOKEN — API token from Atlassian API Tokens

3. Build

npm run build

Usage

With Antigravity

Copy mcp_config.json to your Antigravity config directory and update the environment variables:

# Global config (all projects)
cp mcp_config.json ~/.gemini/config/mcp_config.json

# Or project-specific
cp mcp_config.json .agents/mcp_config.json

Edit the copied file to add your real credentials:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jiri-mcp/dist/index.js"],
      "env": {
        "JIRA_HOST": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Development mode

npm run dev

Production

npm run build
npm start

Example prompts

Once connected, you can ask your AI agent things like:

• "Search for open bugs in project MYAPP"

• "What's the status of MYAPP-123?"

• "Create a task in MYAPP: Fix login timeout with priority High"

• "Move MYAPP-456 to In Progress"

• "Add a comment to MYAPP-789: Deployed fix to staging"

• "Who's assigned to MYAPP-321?"

License

MIT