# keen

> keen is an open-source MCP server for developer tools. Atlassian Cloud CLI and MCP server covering Jira, Confluence, Bitbucket and Admin APIs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Repository:** https://github.com/imogenlabs/keen
- **MCP Registry name:** io.github.imogenlabs/keen
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Keen is a single Go binary that wraps 1,843 Atlassian API endpoints across Jira, Jira Agile, Confluence, Marketplace, Service Desk, Assets, Compass, Bitbucket and Admin, plus Teamwork Graph queries. It also keeps a local SQLite copy with full-text search, so searches can run without calling Atlassian at all.

Its MCP server, keen-mcp, deals with the sheer size of that surface. Listing all 1,939 tools would take about half a million tokens, so by default it offers just two: keen_search, which finds tools for a task and returns their parameters, and keen_run, which runs one by name. Setting KEEN_MCP_TOOLS=all exposes the full list. Reads repeated within five minutes are served from cache to stay under Atlassian rate limits, and any successful write clears it.

You authenticate with your Atlassian site URL, account email and an API token; Admin and private Bitbucket data need separate keys or tokens. The README states it is Apache-2.0, needs no account and sends no telemetry. It installs through Homebrew, deb and rpm packages, Docker or an mcpb bundle for Claude Desktop.

## Features

- **Broad API coverage:** 1,843 endpoints across Jira, Confluence, Bitbucket, Service Desk, Assets, Compass and Admin.
- **Two-tool MCP mode:** keen_search finds tools and keen_run executes them, keeping context small.
- **Local sync and search:** SQLite with FTS5 lets you search synced Jira data offline.
- **Read caching:** Repeated reads within five minutes come from cache; writes clear it.
- **Several install routes:** Homebrew, deb, rpm, Docker, binaries or an mcpb bundle.
- **Admin and Bitbucket:** Includes organisation admin and Bitbucket repositories and pull requests.

## Good for

- Let an agent transition Jira issues and list sprints
- Search Confluence and Jira content locally without API calls
- Script Atlassian automation with typed commands
- Manage Service Desk requests and queues from an agent
- Query the org chart through Teamwork Graph

## Install

### Claude Code (Terminal)

```sh
claude mcp add keen --env JIRA_CLOUD_PLATFORM_URL='<JIRA_CLOUD_PLATFORM_URL>' --env JIRA_CLOUD_PLATFORM_USERNAME='<JIRA_CLOUD_PLATFORM_USERNAME>' --env JIRA_CLOUD_PLATFORM_PASSWORD='<JIRA_CLOUD_PLATFORM_PASSWORD>' -- npx -y https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "keen": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb"
      ],
      "env": {
        "JIRA_CLOUD_PLATFORM_URL": "<JIRA_CLOUD_PLATFORM_URL>",
        "JIRA_CLOUD_PLATFORM_USERNAME": "<JIRA_CLOUD_PLATFORM_USERNAME>",
        "JIRA_CLOUD_PLATFORM_PASSWORD": "<JIRA_CLOUD_PLATFORM_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "keen": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb"
      ],
      "env": {
        "JIRA_CLOUD_PLATFORM_URL": "<JIRA_CLOUD_PLATFORM_URL>",
        "JIRA_CLOUD_PLATFORM_USERNAME": "<JIRA_CLOUD_PLATFORM_USERNAME>",
        "JIRA_CLOUD_PLATFORM_PASSWORD": "<JIRA_CLOUD_PLATFORM_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "keen": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb"
      ],
      "env": {
        "JIRA_CLOUD_PLATFORM_URL": "<JIRA_CLOUD_PLATFORM_URL>",
        "JIRA_CLOUD_PLATFORM_USERNAME": "<JIRA_CLOUD_PLATFORM_USERNAME>",
        "JIRA_CLOUD_PLATFORM_PASSWORD": "<JIRA_CLOUD_PLATFORM_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "keen": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb"
      ],
      "env": {
        "JIRA_CLOUD_PLATFORM_URL": "<JIRA_CLOUD_PLATFORM_URL>",
        "JIRA_CLOUD_PLATFORM_USERNAME": "<JIRA_CLOUD_PLATFORM_USERNAME>",
        "JIRA_CLOUD_PLATFORM_PASSWORD": "<JIRA_CLOUD_PLATFORM_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "keen": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb"
      ],
      "env": {
        "JIRA_CLOUD_PLATFORM_URL": "<JIRA_CLOUD_PLATFORM_URL>",
        "JIRA_CLOUD_PLATFORM_USERNAME": "<JIRA_CLOUD_PLATFORM_USERNAME>",
        "JIRA_CLOUD_PLATFORM_PASSWORD": "<JIRA_CLOUD_PLATFORM_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `keen_search`: Finds keen tools for a task and returns them with their parameters.
- `keen_run`: Runs a keen tool by name.

## FAQ

### What credentials does it need?

Your Atlassian site URL, sign-in email and an Atlassian API token.

### Why only two MCP tools?

Listing every tool would use roughly half a million tokens; set KEEN_MCP_TOOLS=all if you want the full list.

### Is it free?

Yes. The README says it is Apache-2.0 with no account and no telemetry.

### How do I avoid rate limits?

Reads repeated within five minutes are cached; KEEN_MCP_CACHE=off makes every read live.

### Is keen free?

Yes. keen is open source, so you can use and self-host it for free.

### How do I add keen to Claude Code?

Run this command in your terminal: claude mcp add keen --env JIRA_CLOUD_PLATFORM_URL='<JIRA_CLOUD_PLATFORM_URL>' --env JIRA_CLOUD_PLATFORM_USERNAME='<JIRA_CLOUD_PLATFORM_USERNAME>' --env JIRA_CLOUD_PLATFORM_PASSWORD='<JIRA_CLOUD_PLATFORM_PASSWORD>' -- npx -y https://github.com/imogenlabs/keen/releases/download/v1.9.0/keen-mcp.mcpb

### What are the best alternatives to keen?

The closest alternatives to keen are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/keen
