jiri-mcp — Jira MCP Server

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

Features

Tool	Description
search_issues	Search issues with JQL
get_issue	Get full issue details
create_issue	Create new issues
update_issue	Update issue fields
add_comment	Add comments
list_transitions	List available status transitions
transition_issue	Change issue status
assign_issue	Assign/unassign issues
list_projects	List accessible projects
search_users	Search users by name/email

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