Jira

You can run a self-hosted Jira MCP Server to access Jira data and actions from any MCP client. This server provides endpoints to manage issues, search with JQL, handle comments and transitions, manage projects and users, and more, all through a consistent MCP interface. It securely authenticates with a Jira instance using a Personal Access Token (PAT) and keeps your Jira data accessible via MCP tooling.

How to use

You connect to the Jira MCP Server from your MCP client by configuring an MCP server entry that points to the local or remote MCP runtime. Use either the npx-based quick start or a local stdio startup to run the server, then reference the Jira MCP server in your MCP project to perform Jira actions such as creating issues, querying with JQL, and updating fields.

How to install

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server-pro"],
      "env": {
        "JIRA_BASE_URL": "https://your-jira-instance.com/",
        "PAT": "your-personal-access-token"
      }
    }
  }
}

Configuration and security

Set up your Jira connection by creating a .env file at the project root with the Jira base URL and your PAT. This keeps sensitive credentials out of MCP configuration files and allows your MCP client to access Jira securely.

JIRA_BASE_URL=https://your-jira-instance.com/
PAT=your-personal-access-token

Starting the server (local development)

npm install
npm run build
npm start

Using with npx (Recommended)

Run the MCP server via npx without a local install. This is convenient for quick experiments and integration in MCP projects.

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server-pro"],
      "env": {
        "JIRA_BASE_URL": "https://your-jira-instance.com/",
        "PAT": "your-personal-access-token"
      }
    }
  }
}

Global installation

npm install -g jira-mcp-server-pro

Local Development

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jiraMCP/dist/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://your-jira-instance.com/",
        "PAT": "your-personal-access-token"
      }
    }
  }
}

Available tools

jira_get_issue

Get details of a Jira issue by its key

jira_search_issues

Search for issues using JQL

jira_create_issue

Create a new Jira issue with basic fields

jira_create_issue_advanced

Create an issue with full field support (fixVersions, components, custom fields)

jira_update_issue

Update an existing issue with basic fields

jira_update_issue_advanced

Update an issue with full field support

jira_delete_issue

Delete an issue

jira_assign_issue

Assign or unassign an issue

jira_get_transitions

Get available transitions for an issue

jira_transition_issue

Transition an issue to a new status

jira_link_issues

Link two issues

jira_add_watcher

Add a watcher to an issue

jira_get_comments

Get comments on an issue

jira_add_comment

Add a comment to an issue

jira_get_projects

Get all projects

jira_get_project

Get details of a specific project

jira_get_project_versions

Get all versions for a project

jira_get_project_components

Get all components for a project

jira_get_create_meta

Get required fields and allowed values for creating issues

jira_get_edit_meta

Get editable fields and allowed values for an existing issue

jira_get_fields

Get all available fields including custom fields

jira_get_field_options

Get allowed values for a specific field

jira_get_priorities

Get all available priorities

jira_get_statuses

Get all available statuses

jira_get_issue_link_types

Get all available issue link types

jira_search_users

Search for users

jira_get_current_user

Get the current authenticated user