Jira MCP Server
Provides tools for querying Jira boards, issues, user information, and adding comments to Jira issues, enabling AI agents to interact with Jira Cloud.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Jira MCP Server list my issues on board 5"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Jira MCP Server
A modular, extensible Model Context Protocol (MCP) server for interacting with Jira Cloud. This project provides a set of tools to query boards, issues, user information, and more, making it easy to integrate Jira with AI agents, bots, or other automation systems.
🚀 Features
List all available Jira scrum boards
List your own issues for a specific board
Add comments to Jira issues (ADF-compliant)
Get current authenticated user information
Search for users by login, email, or display name
Get Jira server information (including server time)
Modular, extensible, and easy to contribute
Related MCP server: Jira MCP Server
🛠️ Requirements
Node.js 18+
Access to a Jira Cloud instance
Jira API Token (see Jira API Tokens)
⚙️ Environment Variables
Set the following environment variables in your shell or .env file:
JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@company.com
JIRA_API_TOKEN=your-jira-api-token🚀 Quick Start (with npx)
You can run the Jira MCP Server instantly with npx, no global install required:
npx -y @ahmetbarut/jira-mcp-serverOr, if you want to use it as an MCP tool in a config file (e.g. mcp.json):
{
"Jira MCP Server": {
"command": "npx",
"args": ["-y", "@ahmetbarut/jira-mcp-server"],
"env": {
"JIRA_BASE_URL": "https://your-domain.atlassian.net",
"JIRA_EMAIL": "your-email@company.com",
"JIRA_API_TOKEN": "your-jira-api-token"
}
}
}No need for
npm installor global install.All dependencies are handled by
npx.You can set your Jira credentials in the
envsection.
Note: The first run may take a few seconds as
npxdownloads the package.
📦 Installation & Setup
Clone the repository (optional):
git clone https://github.com/ahmetbarut/jira-mcp.git cd jira-mcp-serverInstall globally (optional):
npm install -g @ahmetbarut/jira-mcp-serverSet environment variables:
See above for required variables.
Build the project (if using from source):
npm run buildRun the server:
jira-mcp-server # or npx -y @ahmetbarut/jira-mcp-server
🧩 Usage
This server is designed to be used as an MCP tool server, typically via stdio. You can interact with it using the Model Context Protocol Inspector or integrate it into your own MCP-compatible agent.
Example: List Boards
npx @modelcontextprotocol/inspector --cli npx -y @ahmetbarut/jira-mcp-server --method tools/call --tool-name get_boardsExample: Get Your Issues for a Board
npx @modelcontextprotocol/inspector --cli npx -y @ahmetbarut/jira-mcp-server --method tools/call --tool-name get_issues --tool-arg boardId=123Example: Add a Comment to an Issue
npx @modelcontextprotocol/inspector --cli npx -y @ahmetbarut/jira-mcp-server --method tools/call --tool-name add_comment_to_issue --tool-arg issueIdOrKey=PROJ-123 --tool-arg body="This is a test comment."🧰 Available Tools
get_boards: List all available Jira scrum boards
get_issues: List your issues for a specific board
add_comment_to_issue: Add a comment to a Jira issue (ADF-compliant)
get_current_user_info: Get current authenticated user information
search_user: Search for a user by login, email, or display name
get_server_info: Get Jira server information (including server time)
🏗️ Project Structure
src/index.ts— Main server entry point and tool dispatchersrc/tools.ts— Tool definitions and schemassrc/handlers.ts— Tool handler implementations (business logic)src/jiraApi.ts— Jira API helpers and configurationsrc/types.ts— TypeScript types and interfaces
🤝 Contributing
Contributions are welcome! Please follow these steps:
Fork the repository
Create a new branch for your feature or bugfix:
git checkout -b my-featureWrite clear, well-documented code
Add or update tests if applicable
Open a pull request with a clear description of your changes
Ensure your code passes lint and build checks
Code Style
Use TypeScript and follow the existing modular structure
Keep business logic in
handlers.tsand API helpers injiraApi.tsWrite clear commit messages
Issues
If you find a bug or have a feature request, please open an issue on GitHub with as much detail as possible.
📄 License
This project is licensed under the MIT License. See LICENSE for details.
Happy automating with Jira MCP Server!
Available Tools
7 toolsadd_comment_to_issueB
Add a comment to a specific Jira issue
Inputs: body (required), issueIdOrKey (required).
get_boardsA
Get all available Jira scrum boards
Inputs: no named parameters.
get_current_user_infoA
Get current authenticated user information including login, email, timezone
Inputs: no named parameters.
get_issue_detailB
Get detailed information about a specific Jira issue
Inputs: issueIdOrKey (required).
get_issuesB
Get current user's tasks from a specific Jira board
Inputs: boardId (required).
get_server_infoA
Get Jira server information including current server time
Inputs: no named parameters.
search_userB
Search for a user by login name or email
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource or action: boards, issues, user info, server info, and comments. There is no overlap in functionality.
All tool names follow a consistent verb_noun pattern using snake_case, e.g., get_boards, get_issues, add_comment_to_issue. The naming is predictable and clear.
With 7 tools, the set is well-scoped for a Jira server, covering essential operations on boards, issues, users, and server info without being excessive.
The set lacks issue creation, update, and deletion, which are core operations for a Jira server. Agents cannot complete full issue lifecycle tasks, leaving notable gaps.
Related MCP Connectors
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage Jira Cloud instances, including creating and updating issues, managing sprints and projects, adding comments, tracking worklogs, and searching with presets.4 npmMIT
- AlicenseAqualityNot gradedmaintenanceEnables AI assistants to interact with Atlassian Jira Cloud, allowing users to manage projects, issues, comments, and workflows through natural language commands.61,667 npm3-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Jira Cloud through the REST API, supporting project management, issue operations (create, read, update, delete), JQL search, task assignments, and status transitions.-
- AlicenseBqualityDmaintenanceEnables AI agents to manage Jira projects and issues using natural language, including creating, updating, searching issues, managing sprints, and more via the Jira API.361,667 npm1MIT