Jira

You can extend your AI assistant with direct Jira capabilities by running a dedicated MCP server. This server exposes a focused tool to fetch Jira issue details and lets your AI agents interact with Jira issues safely and programmatically.

How to use

To use this MCP server, select the jira_mcp server in your MCP client and call the get_issue tool. Provide the issueKey of the Jira issue you want to inspect, for example PROJ-123. The tool will return details about that issue so your AI assistant can summarize, route, or act on it.

How to install

Prerequisites you need before installing: Node.js and npm are installed on your system.

Clone the MCP Jira server repository, install dependencies, and build the project with these commands:

# Clone the repository
git clone https://github.com/kuvanov-2/mcp-server-jira.git
cd mcp-server-jira

# Install dependencies
npm install

# Build the project
npm run build

Additional configuration and requirements

Set up secure access to Jira and enable script-based environment variable resolution. You will use 1Password CLI to securely supply sensitive credentials at runtime.

Prepare 1Password CLI and Jira API token as follows:

# Install 1Password CLI
brew install 1password-cli

# Enable CLI integration in the 1Password desktop app settings
# Generate or store the Jira API token in 1Password for reference

Server configuration example

You configure the MCP server exposure in your IDE or MCP client by providing the following stdio configuration. It uses a local script to start the server and obtain the Jira credentials from 1Password.

{
  "mcpServers": {
	"github.com/kuvanov-2/mcp-server-jira": {
	  "command": "/path/to/mcp-server-jira/start-server.sh",
	  "env": {
		"JIRA_HOST": "https://your-domain.atlassian.net",
		"JIRA_EMAIL": "your-email@example.com",
		"JIRA_API_TOKEN": "op://YOUR_VAULT_NAME/YOUR_ITEM_NAME/info/access token" 
	  },
	  "disabled": false,
	  "autoApprove": []
	}
  }
}

Usage details for the Jira get_issue tool

The server provides a single tool to retrieve Jira issue details called get_issue. Use it to obtain the current status, description, assignees, and other metadata for a specific Jira issue.

Troubleshooting and notes

If the server does not start, verify that the JIRA_HOST, JIRA_EMAIL, and JIRA_API_TOKEN environment variables are correctly provided and that the Jira API token is stored in 1Password as described.

Ensure you have built the project after cloning and before starting the server, as the build step compiles the runtime artifacts required by the start script.

Available tools

get_issue

Fetches details for a Jira issue by its issue key, returning fields such as summary, status, assignee, and other metadata.