jira-easy-mcp

Another Model Context Protocol (MCP) server for Jira, without Auth token. Provides tools for complete Jira automation including issues, projects, boards, sprints, comments, worklogs, and more.

Tested on: Jira Server v7.12.3 (self-hosted)

🔑 Why This MCP?

Works with Basic Authentication (username + password) — no API tokens required!

Most Jira MCP servers require OAuth or API tokens, which many organizations restrict or don't allow. This MCP uses HTTP Basic Authentication, so you can connect using just your Jira username and password. Perfect for:

🏢 Enterprise environments where admins don't allow API token creation
🔒 Self-hosted Jira Server instances without OAuth configured
⚡ Quick setup without going through IT approval processes

Quick Start

VS Code (Workspace Configuration)

Create .vscode/mcp.json in your workspace root:

{
  "servers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "jira-easy-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://your-jira-instance.com",
        "JIRA_USERNAME": "your-username",
        "JIRA_PASSWORD": "your-password",
        "JIRA_PROJECTS_FILTER": "ABC,DEF,XYZ",
        "JIRA_RESPONSE_FORMAT": "JSON"
      }
    }
  }
}

Add to your VS Code settings for accessing in all workspaces.

Note: JIRA_PROJECTS_FILTER and JIRA_RESPONSE_FORMAT are optional. Projects filter limits access to specified projects. Response format can be JSON (default) or TOON (text-oriented notation).

Other IDEs

Cursor: Manually add the configuration above to your Cursor settings(use "mcp": { "servers": { ... } } wrapper)
Windsurf: Add to your Windsurf MCP settings: (use "mcp": { "servers": { ... } } wrapper)
Claude Desktop: Edit ~/.claude/mcp.json (use "mcpServers": { ... } wrapper)

All use the same command, args, and env configuration as VS Code above.

Common Use Cases

| Task | Tool | Example Prompt | | --- | --- | --- | | Search issues | jira_search | "Search for all open bugs assigned to me in project ABC" | | Get issue details | jira_get_issue | "Show me the details of issue ABC-123" | | Create issue | jira_create_issue | "Create a new bug in project ABC with title 'Login button not working'" | | Update issue | jira_update_issue | "Change the priority of ABC-123 to High and assign it to john.doe" | | Add comment | jira_add_comment | "Add a comment to ABC-123 saying 'Fix deployed to staging'" | | Change status | jira_transition_issue | "Move ABC-123 to Done" | | Log time | jira_add_worklog | "Log 2 hours of work on ABC-123 for yesterday" | | List projects | jira_get_projects | "Show me all projects I have access to" | | View sprints | jira_get_sprints | "What's in the current sprint for project ABC?" | | Link issues | jira_create_link | "Link ABC-123 as blocking ABC-124" | | Generate filter URL | jira_generate_filter_url | "Create a shareable link for all open bugs updated in the last 7 days" |

Testing with MCP Inspector

The MCP Inspector provides a web UI to test all tools interactively:

npx @modelcontextprotocol/inspector npx jira-easy-mcp

This opens a browser at http://localhost:6274 where you can:

View all available tools
Test each tool with custom parameters
See the raw JSON responses

Note: Put these values inside inspector UI before connecting: JIRA_BASE_URL, JIRA_USERNAME, JIRA_PASSWORD.

Optional Environment Variables

| Variable | Default | Description | | --- | --- | --- | | JIRA_PROJECTS_FILTER | (none) | Comma-separated project keys to limit access | | JIRA_RESPONSE_FORMAT | JSON | Response format: JSON or TOON | | JIRA_LOG_LEVEL | INFO | Log verbosity: DEBUG, INFO, WARN, ERROR | | JIRA_TIMEOUT | 30000 | Request timeout in milliseconds | | JIRA_RETRY_COUNT | 3 | Number of retries for failed requests | | JIRA_RETRY_DELAY | 1000 | Base delay between retries (ms) | | JIRA_SSL_VERIFY | true | Set to false to skip SSL verification | | JIRA_CACHE_TTL | 300 | Cache TTL in seconds for static data |

Compatibility

| Jira Version | Status | | --- | --- | | Jira Server v7.12.3 | ✅ Tested | | Jira Server v8.x | ✅ Tested | | Jira Cloud | ︖ Not tested (Use official MCP) |

You can improve this by reporting issues

MCP Servers