A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow transitions.
A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations.
While Atlassian provides an official MCP connector, our implementation offers superior flexibility and real-world problem-solving capabilities. We’ve built this connector to address the daily challenges developers and project managers actually face, not just basic API operations.
Key Advantages:
Before you begin, you’ll need:
We recommend Docker for the easiest setup:
## Pull the latest image
docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest
## Test it works (replace with your details)
docker run --rm \
-e ATLASSIAN_HOST=your-company.atlassian.net \
-e [email protected] \
-e ATLASSIAN_TOKEN=your-api-token \
ghcr.io/nguyenvanduocit/jira-mcp:latest \
--http_port 3000
jira-mcp_darwin_amd64jira-mcp_linux_amd64jira-mcp_windows_amd64.exechmod +x jira-mcp_*
sudo mv jira-mcp_* /usr/local/bin/jira-mcp
go install github.com/nguyenvanduocit/jira-mcp@latest
{
"mcpServers": {
"jira": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "ATLASSIAN_HOST=your-company.atlassian.net",
"-e", "[email protected]",
"-e", "ATLASSIAN_TOKEN=your-api-token",
"ghcr.io/nguyenvanduocit/jira-mcp:latest"
]
}
}
}
{
"mcpServers": {
"jira": {
"command": "/usr/local/bin/jira-mcp",
"env": {
"ATLASSIAN_HOST": "your-company.atlassian.net",
"ATLASSIAN_EMAIL": "[email protected]",
"ATLASSIAN_TOKEN": "your-api-token"
}
}
}
}
List my Jira projects
Show me issues assigned to me
What's in the current sprint?
If you see Jira data, congratulations! 🎉 You’re all set up.
Create a .env file for easier management:
## .env file
ATLASSIAN_HOST=your-company.atlassian.net
[email protected]
ATLASSIAN_TOKEN=your-api-token
Then use it:
## With binary
jira-mcp -env .env
## With Docker
docker run --rm -i --env-file .env ghcr.io/nguyenvanduocit/jira-mcp:latest
For development and testing, you can run in HTTP mode:
## Start HTTP server on port 3000
jira-mcp -env .env -http_port 3000
Then configure Cursor with:
{
"mcpServers": {
"jira": {
"url": "http://localhost:3000/mcp"
}
}
}
Once configured, you can ask Claude to help with Jira tasks using natural language:
❌ “Connection failed” or “Authentication error”
ATLASSIAN_HOST (should be like company.atlassian.net)❌ “No MCP servers found”
❌ “Permission denied” errors
-http_port to see detailed error messagesFor local development and contributing:
## Clone the repository
git clone https://github.com/nguyenvanduocit/jira-mcp.git
cd jira-mcp
## Create .env file with your credentials
cp .env.example .env
## Edit .env with your details
## Run in development mode
just dev
## or
go run main.go -env .env -http_port 3002
## Test with MCP inspector
npx @modelcontextprotocol/inspector http://localhost:3002/mcp
git checkout -b feature/amazing-feature)git commit -m 'feat: add some amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE{:target=“_blank”} file for details.
Need help? Check our CHANGELOG.md{:target=“_blank”} for recent updates or open an issue on GitHub.
