Skip to main content
Prerequisites: - Python 3.11 or higher - UV package manager - jira-cli installed and configured

​
Getting started

Clone the repository and set up your development environment: 
git clone https://github.com/xcollantes/jira-mcp.git
cd jira-mcp
uv sync

​
Pre-commit hooks

This project uses pre-commit to run ruff linting and formatting checks, and pytest tests before each commit.
1

Install pre-commit hooks

uv sync
uv run pre-commit install
2

Run checks manually

Once installed, ruff and pytest will automatically run when you commit. To run checks manually on all files:
uv run pre-commit run --all-files

​
Logging

Do not use print statements for logging. Use the logging module instead. Writing to stdout will corrupt the JSON-RPC messages and break your server.

​
Docstrings and tool decorators

MCP tools decorator parameters are especially important as this is the human-readable text that the LLM has context of. This will be treated as part of the prompt when fed to the LLM and this will decide when to use each tool.

​
Troubleshooting

On macOS:
/Users/<your-username>/.config/.jira/.config.yml
If you get a 404 error when using jira init, you may need to edit the jira-cli config file to point to the correct Jira instance.There are only 3 possible values for the auth type, so try each one:
  • basic
  • password
  • bearer