jira-dashboard-mcp

Model Context Protocol (MCP) server for Jira dashboard management — create dashboards, add and configure gadgets, and manage filters via JQL.

Tools

Dashboard

| Tool | Description | |------|-------------| | create_dashboard | Create a new Jira dashboard | | get_dashboard | Get dashboard details by ID | | list_dashboards | Search dashboards visible to the current user | | update_dashboard | Update dashboard name / description / permissions | | delete_dashboard | Delete a dashboard |

Gadgets

| Tool | Description | |------|-------------| | list_gadgets | List all gadgets on a dashboard | | add_gadget | Add a gadget by type or custom URI | | configure_gadget | Configure gadget filter, stat type, and display options | | get_gadget_config | Read current gadget configuration | | remove_gadget | Remove a gadget from a dashboard | | list_available_gadgets | List all gadget types available in your Jira instance | | copy_gadget_config | Copy configuration from one gadget to another |

Filters

| Tool | Description | |------|-------------| | create_filter | Create a filter from a JQL query | | get_filter | Get filter details by ID | | update_filter | Update filter name / JQL / description | | delete_filter | Delete a filter | | search_filters | Search filters by name |

High-level

| Tool | Description | |------|-------------| | create_dashboard_with_gadgets | Create a dashboard and configure multiple gadgets in a single call |

Supported gadget types

Pass these as gadgetType to add_gadget or create_dashboard_with_gadgets:

| Key | Gadget | |-----|--------| | pie-chart | Pie Chart — tickets by status, priority, assignee, etc. | | two-dimensional | Two Dimensional Filter Statistics — cross-tab (e.g. Priority × Status) | | filter-results | Filter Results — live ticket table | | work-item-stats | Work Item Statistics — bar chart by field | | created-vs-resolved | Created vs Resolved — trend chart | | average-age | Average Age Chart | | resolution-time | Resolution Time Chart | | workload-pie | Workload Pie | | recently-created | Recently Created Issues Chart | | time-since | Time Since Chart |

Setup

1. Install

npm install -g jira-dashboard-mcp

Or use directly via npx:

npx jira-dashboard-mcp

2. Configure environment variables

| Variable | Description | |----------|-------------| | JIRA_BASE_URL | Your Jira instance URL, e.g. https://yourorg.atlassian.net | | JIRA_USER_EMAIL | Your Atlassian account email | | JIRA_API_TOKEN | Atlassian API token — create at id.atlassian.com |

3. Add to Claude Code (or any MCP client)

In your MCP config (e.g. ~/.claude.json):

{
  "mcpServers": {
    "jira-dashboard-mcp": {
      "command": "npx",
      "args": ["-y", "jira-dashboard-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://yourorg.atlassian.net",
        "JIRA_USER_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Example — create a Code Yellow dashboard for one SBU

create_dashboard_with_gadgets
  name: "OEC-DaaS Code Yellow Dashboard"
  gadgets:
    - gadgetType: pie-chart
      title: "Status Breakdown"
      filterId: "filter-31848"
      statType: "statuses"
      color: blue

    - gadgetType: pie-chart
      title: "Priority Breakdown"
      filterId: "filter-31848"
      statType: "priorities"
      color: red

    - gadgetType: two-dimensional
      title: "Priority × Status Matrix"
      filterId: "filter-31848"
      xstattype: "priorities"
      ystattype: "statuses"
      color: yellow

    - gadgetType: filter-results
      title: "Open Tickets"
      filterId: "filter-31848"
      columnNames: "issuetype|issuekey|summary|priority|status|assignee|created"
      numResults: "20"
      color: green

License

MIT