Lets agents list Jira Cloud projects, search and read issues with JQL, work with comments and view linked commits and pull requests.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add atlassian-jira --env ATLASSIAN_SITE_NAME='<ATLASSIAN_SITE_NAME>' --env ATLASSIAN_USER_EMAIL='<ATLASSIAN_USER_EMAIL>' --env ATLASSIAN_API_TOKEN='<ATLASSIAN_API_TOKEN>' -- npx -y @aashari/mcp-server-atlassian-jira~/.codex/config.toml
[mcp_servers.atlassian-jira]
command = "npx"
args = ["-y", "@aashari/mcp-server-atlassian-jira"]
env = { ATLASSIAN_SITE_NAME = "<ATLASSIAN_SITE_NAME>", ATLASSIAN_USER_EMAIL = "<ATLASSIAN_USER_EMAIL>", ATLASSIAN_API_TOKEN = "<ATLASSIAN_API_TOKEN>" }
# codex mcp add atlassian-jira --env ATLASSIAN_SITE_NAME='<ATLASSIAN_SITE_NAME>' --env ATLASSIAN_USER_EMAIL='<ATLASSIAN_USER_EMAIL>' --env ATLASSIAN_API_TOKEN='<ATLASSIAN_API_TOKEN>' -- npx -y @aashari/mcp-server-atlassian-jira~/.cursor/mcp.json
{
"mcpServers": {
"atlassian-jira": {
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-jira"
],
"env": {
"ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
"ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
"ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"atlassian-jira": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-jira"
],
"env": {
"ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
"ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
"ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"atlassian-jira": {
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-jira"
],
"env": {
"ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
"ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
"ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"atlassian-jira": {
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-jira"
],
"env": {
"ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
"ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
"ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"atlassian-jira": {
"command": "npx",
"args": [
"-y",
"@aashari/mcp-server-atlassian-jira"
],
"env": {
"ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
"ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
"ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
}
}
}
}Environment variables
ATLASSIAN_SITE_NAMEATLASSIAN_USER_EMAILATLASSIAN_API_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.