Jira MCP Server
About
Jira MCP Server is a Model Context Protocol server that integrates with Jira, enabling LLMs to interact with Jira projects, boards, sprints, and issues via its REST API.
Details
- Author
- MCP-Mirror
- Downloads
- 317
- Categories
- Developer Tools, Project Management
Jump to
- Lists Jira projects with optional filters and expand parameters.
- Lists boards from a project by key or ID.
- Lists sprints from a specific board.
- Lists issues from a given sprint.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Jira MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install via npx with environment variables JIRA_PERSONAL_ACCESS_TOKEN and JIRA_BASE_URL. Configure in Claude Desktop’s claude_desktop_config.json. Requires Node version 22.12.0 or above.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"jira mcp server": {
"jira": {
"command": "npx",
"args": [
"-y",
"@parassolanki/jira-mcp-server@latest"
],
"env": {
"JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
"JIRA_BASE_URL": "jira_base_url"
}
}
}
}
}McpServers
{
"jira": {
"command": "npx",
"args": [
"-y",
"@parassolanki/jira-mcp-server@latest"
],
"env": {
"JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
"JIRA_BASE_URL": "jira_base_url"
}
}
}Jira MCP Server
A Model Context Protocol Server for Jira.
Provides integration with Jira through MCP, allowing LLMs to interact with it.
Installation
Manual Installation
> Note: Requires Node version to be 22.12.0 or above
1. Create or get Jira Personal Access Token: Guide
2. Add server config to Claude Desktop:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: Check this Guide
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "@parassolanki/jira-mcp-server@latest"],
"env": {
"JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
"JIRA_BASE_URL": "jira_base_url"
}
}
}
}
For Windows:
{
"mcpServers": {
"jira": {
"command": "cmd /c npx",
"args": ["-y", "@parassolanki/jira-mcp-server@latest"],
"env": {
"JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
"JIRA_BASE_URL": "jira_base_url"
}
}
}
}
Components
Tools
1. list_projects: List projects from Jira.
- Required inputs:
- query (optional string): A query string used to filter the returned projects.
- maxResults (optional number, max: 100): The maximum number of results to return.
- expand (optional string): Expand additional information in the response. (comma separated description, lead, issueTypes, url, projectKeys, permissions and insight).
2. list_boards: List boards from a project.
- Required inputs:
- projectKeyOrId (string): Key or Id of the project.
- name (optional string): Name of the project.
- maxResults (optional number, max: 100): The maximum number of results to return.
- startAt (optional number): The starting index of the returned boards.
- type (optional string): The type of boards. (can be one of scrum or kanban).
3. list_sprints_from_board: List sprints from a board.
- Required inputs:
- boardId (string): The ID of the board.
- maxResults (optional number, max: 100): The maximum number of results to return.
- startAt (optional number): The starting index of the returned boards.
4. list_issues_from_sprint: List issues from a sprint.
- Required inputs:
- boardId (string): The ID of the board.
- sprintId (string): The ID of the sprint.
- maxResults (optional number, max: 100): The maximum number of results to return.
- startAt (optional number): The starting index of the returned boards.
- expand (optional string): Expand additional information in the response. (comma separated schema and names).
Usage examples
Some example prompts you can use to interact with Jira:
1. "Show me all Jira projects" → execute the list_projects tool to see all available projects.
2. "What Kanban boards exist in the DEV project?" → execute the list_boards tool with the DEV project key and type parameter set to "kanban".
3. "Show me all the sprints for board ID 123" → execute the list_sprints_from_board tool to see all sprints associated with board 123.
4. "What issues are in sprint 456 on board 123?" → execute the list_issues_from_sprint tool to see all issues in sprint 456 on board 123.
5. "Show me the first 50 issues from the current sprint on the Marketing board" → first execute list_boards to find the Marketing board ID, then list_sprints_from_board to find the current sprint, then list_issues_from_sprint with maxResults=50.
Development
1. Install dependencies:
pnpm install
2. Configure Github Access token in .env:
JIRA_PERSONAL_ACCESS_TOKEN=email@example.com:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url
3. Run locally with watch:
pnpm dev
4. Build the server:
pnpm build
5. Local debugging with inspector:
pnpm inspector
TODOS
- [x] list_projects
- [x] list_boards
- [x] list_sprints_from_board
- [x] list_issues_from_sprint
- [ ] get_issue_by_id_or_key
- [ ] create_issue
- [ ] update_issue
- [ ] delete_an_issue
- [ ] archieve_an_issue
- [ ] list_comments_from_issue
- [ ] get_comment_from_issue_by_id
- [ ] create_comment_in_issue
- [ ] update_comment_of_issue
- [ ] delete_comment_of_issue
- [ ] list_subtasks_from_issue
- [ ] get_user_by_username_or_key
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
