​

Jira MCP Setup Guide for Cursor

​

Prerequisites

• Node.js 18 or higher
• Jira Cloud account (this MCP supports Jira Cloud only, not self-hosted)
• Atlassian API token

​

Step 1: Create an Atlassian API Token

1. Go to Atlassian API Tokens
2. Click Create API token
3. Give it a label (e.g., Cursor MCP or Jira AI)
4. Click Create
5. Copy the token immediately — you won’t be able to see it again

​

Step 2: Find Your Jira Site Name

​

Step 3: Add Jira MCP to Cursor

​

Option A: Edit config file directly

1. Open your Cursor MCP config:
   • macOS/Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json
2. Add the jira server to the mcpServers object. Your config should look like:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-existing-github-token"
      }
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@aashari/mcp-server-atlassian-jira"],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "your.email@company.com",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

3. Replace the placeholders:
   • your-company → Your Jira site name (e.g., suki for suki.atlassian.net)
   • your.email@company.com → Your Atlassian account email
   • your_api_token → The API token from Step 1

​

Option B: Use Cursor Settings UI

1. Open Cursor Settings (Cmd+, or Ctrl+,)
2. Go to Tools & Integrations → MCP Servers
3. Click Add new MCP server
4. Configure the Jira server with the same values as above

​

Step 4: Restart Cursor

​

What You Can Do

• Create tickets: “Create a Jira task in project DEV: Fix login bug”
• Search issues: “Find all high priority issues in the PLATFORM project”
• Get issue details: “Show me details about PROJ-123”
• Add comments: “Add a comment to PROJ-456: Code review completed”
• Update issues: “Update status of PROJ-123 to In Progress”

​

Troubleshooting

​

”Authentication failed” or “403 Forbidden”

• Verify your API token is active at Atlassian API Tokens
• Ensure site name is correct (no .atlassian.net, just the subdomain)

​

“Resource not found” or “404”

• Use project keys (e.g., DEV) not project names
• Issue keys include the project prefix (e.g., DEV-123)

​

Test your connection

npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/myself"

​

Alternative: Full Atlassian MCP (Confluence + Jira)

1. Clone and run the server:

git clone https://github.com/samwang0723/mcp-atlassian.git
cd mcp-atlassian
# Create .env with ATLASSIAN_HOST, ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN
npm install && npm start

2. Add to config with streamable-http:

"atlassian": {
  "url": "http://localhost:3007/mcp",
  "type": "streamable-http"
}

​

Reference

• Jira MCP Server (npm)
• GitHub Repository
• Cursor MCP Docs