jira

This Jira MCP Server provides a compact, tool-based interface to interact with Jira Cloud. It exposes five compound tools, each with a specific action to perform common Jira operations: jira_issues for full issue lifecycle management (get, create, update, assign); jira_search for discovering issues, projects, users, and metadata via create_metadata; jira_comments for reading and writing issue comments; jira_workflow for retrieving transitions and applying transitions to change an issue's status; and jira_attachments for listing, uploading, downloading, and deleting attachments. By using these five tools, you can perform complex Jira workflows with fewer tool definitions, reducing token usage while maintaining rich capability. When integrating with Claude or another assistant, query the appropriate tool with the required action and parameters (e.g., action: get on jira_issues to fetch details for issue PROJ-123, or action: create_metadata via jira_search to learn required fields before creating an issue).

To use the MCP server, configure it in your Claude Desktop MCP settings as shown in the provided configuration examples. You can run the server via npx (recommended) or build from source and run the built index.js. Ensure your environment variables (JIRA_EMAIL, JIRA_API_TOKEN, JIRA_BASE_URL) are set so the server can authenticate with Jira Cloud.

Prerequisites:

• Node.js v16 or newer installed on the machine
• npm or pnpm
• A Jira Cloud account with API access and a generated API token

Installation steps (recommended approach using npm):

1. Install the MCP server globally via npm:

npm install -g @nexus2520/jira-mcp-server

2. Start the MCP server (npx-based approach):

# Using npx as configured in mcp_config

3. If you prefer building from source:

git clone https://github.com/pdogra1299/jira-mcp-server.git
cd jira-mcp-server
pnpm install
pnpm run build

4. In Claude Desktop (or your MCP client), add the server configuration as shown in the README, pointing to the npm-based command or to the built index.js if you built from source.

Prerequisites recap:

• Node.js >= 16.0.0
• Jira Cloud account with API access
• Jira API token (from Atlassian account settings)

Environment variables are required for Jira integration. Ensure JIRA_BASE_URL is set to your Jira Cloud URL (e.g., https://yourcompany.atlassian.net). When using create operations, it’s recommended to run jira_search with action=create_metadata first to discover required fields and allowed values for the target project/issue type. For attachments, note that text files are returned as readable text and images can be rendered inline by Claude vision when retrieved via get_content. If you encounter authentication errors, double-check the API token and that the email used corresponds to a Jira Cloud user with API access.