This repository contains a Model Context Protocol (MCP) server that connects your AI assistants (like Cursor, Gemini, Claude Desktop) directly to any self-hosted Jira Server or Jira Cloud instance. It enables your AI to seamlessly manage tasks, create issues, and query your project management workflow without leaving the chat interface.
> *"Create a new task in the PQCAL Mobile project (PCM) to 'Fix the broken login button on iOS'. The description should say that it crashes on the staging environment."*
> *"I just realized we need a new button on the dashboard. Please create a Jira ticket for this." (Requires an active project to be set!)*
```
Create a new task in the PQCAL Mobile project (PCM) to 'Fix the broken login button on iOS'. The description should say that it crashes on the staging environment.
```
```
I just realized we need a new button on the dashboard. Please create a Jira ticket for this. (Requires an active project to be set!)
```
#### Creating Issues with Subtasks
> *"Create a story titled 'Allow Admin to Change Trader of an Investor' with the following subtasks:*
> *- Front-end: Design*
> *- Back-end: Develop"*
> *"Create a Task titled 'Migrate database' with subtasks:*
> *- Backup*
> *- Run migration*
> *- Verify data"*
```
Create a story titled 'Allow Admin to Change Trader of an Investor' with the following subtasks:
- Front-end: Design
- Back-end: Develop
```
```
Create a Task titled 'Migrate database' with subtasks:
- Backup
- Run migration
- Verify data
```
#### Advanced Task Creation
> *"Create a major priority bug for the 'login' component, assigned to 'shahidul', with label 'frontend', environment 'iOS', due '2026-10-31', and an original estimate of '3d 4h'. Support this with description X."*
```
Create a major priority bug for the 'login' component, assigned to 'shahidul', with label 'frontend', environment 'iOS', due '2026-10-31', and an original estimate of '3d 4h'. Support this with description X.
```
#### Bulk Issue Creation
> *"I have a list of 5 tasks I need created at once in PQCI:*
> *- Update logo*
> *- Fix header bug (issue_type=Bug)*
> *- Write documentation*
> *- Audit dependencies*
> *- Update readme"*
```
I have a list of 5 tasks I need created at once in PQCI:
- Update logo
- Fix header bug (issue_type=Bug)
- Write documentation
- Audit dependencies
- Update readme
```
### 👤 Modifying Assignments
> *"Assign the ticket PCM-228 to me."*
> *"Assign PCM-155 to the QA tester."*
> *"Who is the designated tester?"*
> *"Create a new task for 'Update API Documentation' in PCM, and assign it to me right away."*
```
Assign the ticket PCM-228 to me.
```
```
Assign PCM-155 to the QA tester.
```
```
Who is the designated tester?
```
```
Create a new task for 'Update API Documentation' in PCM, and assign it to me right away.
```
### 🔄 Updating Statuses
> *"I just finished working on PCM-131. Please transition it to 'Ready for QA'."*
> *"Move PQCI-873 to 'Start Progress'."*
> *"What transitions are currently available for my task PCM-228?"*
```
I just finished working on PCM-131. Please transition it to 'Ready for QA'.
```
```
Move PQCI-873 to 'Start Progress'.
```
```
What transitions are currently available for my task PCM-228?
```
### 💬 Communication & Time Logging
> *"Can you fetch the comments on issue PCM-123?"*
> *"Add a comment to PQCI-875 saying: 'I've addressed the feedback in my latest PR.'"*
> *"Log 2h 30m of work on PCM-229."*
```
Can you fetch the comments on issue PCM-123?
```
```
Add a comment to PQCI-875 saying: 'I've addressed the feedback in my latest PR.'
```
```
Log 2h 30m of work on PCM-229.
```
### 🔍 Advanced Search (JQL)
> *"Find all issues in the PCM project containing the word 'login' that are unassigned."*
> *"List all high-priority bugs reported this week."*
> *"What issues are currently in 'Ready for QA' status for PQCI?"*
```
Find all issues in the PCM project containing the word 'login' that are unassigned.
```
```
List all high-priority bugs reported this week.
```
```
What issues are currently in 'Ready for QA' status for PQCI?
```
---
## 🤝 Contributing
We welcome contributions from everyone! Whether you're fixing bugs, adding new features, improving documentation, or suggesting enhancements, your help is greatly appreciated.
### How to Contribute
1.**Fork the repository** - Click the fork button on GitHub
2.**Create a new branch** - `git checkout -b feature/your-feature-name` or `git checkout -b bugfix/your-bug-fix`
3.**Make your changes** - Implement your feature or bug fix
4.**Test your changes** - Ensure everything works as expected
5.**Commit your changes** - `git commit -m "Clear description of your changes"`
6.**Push to your branch** - `git push origin feature/your-feature-name`
7.**Create a Pull Request** - Submit a PR with a clear description of your changes
### Areas for Enhancement
- Additional Jira operations and features
- Better error handling and logging
- Support for more MCP clients
- Improved documentation and examples
- Performance optimizations
- Unit tests and test coverage
- Bug fixes and reliability improvements
### Code Style
Please ensure your code follows Python best practices and is well-documented. Include comments for complex logic and write clear commit messages.
Thank you for helping us build and improve this project! 🚀