MCP server for Jira with scoped API tokens — the only server that supports Atlassian's modern authentication
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add jira-scoped --env JIRA_INSTANCE='<JIRA_INSTANCE>' --env JIRA_USER_EMAIL='<JIRA_USER_EMAIL>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' -- npx -y mcp-jira-scoped~/.codex/config.toml
[mcp_servers.jira-scoped]
command = "npx"
args = ["-y", "mcp-jira-scoped"]
env = { JIRA_INSTANCE = "<JIRA_INSTANCE>", JIRA_USER_EMAIL = "<JIRA_USER_EMAIL>", JIRA_API_TOKEN = "<JIRA_API_TOKEN>" }
# codex mcp add jira-scoped --env JIRA_INSTANCE='<JIRA_INSTANCE>' --env JIRA_USER_EMAIL='<JIRA_USER_EMAIL>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' -- npx -y mcp-jira-scoped~/.cursor/mcp.json
{
"mcpServers": {
"jira-scoped": {
"command": "npx",
"args": [
"-y",
"mcp-jira-scoped"
],
"env": {
"JIRA_INSTANCE": "<JIRA_INSTANCE>",
"JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"jira-scoped": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-jira-scoped"
],
"env": {
"JIRA_INSTANCE": "<JIRA_INSTANCE>",
"JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"jira-scoped": {
"command": "npx",
"args": [
"-y",
"mcp-jira-scoped"
],
"env": {
"JIRA_INSTANCE": "<JIRA_INSTANCE>",
"JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"jira-scoped": {
"command": "npx",
"args": [
"-y",
"mcp-jira-scoped"
],
"env": {
"JIRA_INSTANCE": "<JIRA_INSTANCE>",
"JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"jira-scoped": {
"command": "npx",
"args": [
"-y",
"mcp-jira-scoped"
],
"env": {
"JIRA_INSTANCE": "<JIRA_INSTANCE>",
"JIRA_USER_EMAIL": "<JIRA_USER_EMAIL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
}
}
}
}Environment variables
JIRA_INSTANCEJIRA_USER_EMAILJIRA_API_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.