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_amd64
jira-mcp_linux_amd64
jira-mcp_windows_amd64.exe
chmod +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.
An MCP server that provides tools for retrieving and processing documentation through vector search, both locally or hosted. Enabling AI assistants to augment their responses with relevant documentation context.
A open-source library enabling AI models to control hardware devices via serial communication using the MCP protocol. Initial support for Raspberry Pi Pico.
MCP server for RAG-based document search and management
MCP Server for TaskWarrior!