# Atlassian (browser SSO)

> Atlassian (browser SSO) is an open-source MCP server for browser automation. Jira and Confluence behind corporate SSO, using your browser session instead of tokens. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS
- **Repository:** https://github.com/geiserx/atlassian-browser-mcp
- **MCP Registry name:** io.github.GeiserX/atlassian-browser-mcp
- **Categories:** [browser automation](https://ai-powered.com/categories/browser-automation), [productivity](https://ai-powered.com/categories/productivity), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

For teams on Atlassian Server or Data Center where SSO (Okta, SAML) blocks API tokens, this wraps the upstream mcp-atlassian toolset and authenticates with browser cookies captured through Playwright. You log in once per service using a bundled CLI; the server itself never opens a browser, so it never hangs waiting for one, and it returns an AuthRequiredError when cookies expire.

The README lists 63 Jira tools (38 read-only, 25 write) and 35 Confluence tools (20 read-only, 15 write), each carrying all four annotation hints so clients can auto-approve reads and confirm writes. READ_ONLY_MODE=true hides every write tool, and cookie jars are separate per host with mode 0600. On macOS it can reuse a live session from Chromium-family browsers, reading that browser's Keychain key and saying so on stderr.

Licensed GPL-3.0-or-later. MCP 2026-07-28 is not yet supported because upstream pins older libraries.

## Features

- **SSO cookie auth:** Reuses a browser login instead of an API token.
- **Full Jira and Confluence toolset:** Wraps every upstream mcp-atlassian tool.
- **Read-only mode:** READ_ONLY_MODE hides all write tools.
- **Auth status tool:** Tells an agent which service needs a login.
- **Separate cookie jars:** Each host's cookies are stored apart with restrictive permissions.

## Good for

- Searching Jira issues behind Okta SSO
- Reading Confluence pages without an API token
- Letting an agent transition tickets with confirmation
- Scripting issue and page lookups through the CLI

## Install

### Claude Code (Terminal)

```sh
claude mcp add atlassian-browser-mcp -- uvx atlassian-browser-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "atlassian-browser-mcp": {
      "command": "uvx",
      "args": [
        "atlassian-browser-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "atlassian-browser-mcp": {
      "command": "uvx",
      "args": [
        "atlassian-browser-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "atlassian-browser-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "atlassian-browser-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "atlassian-browser-mcp": {
      "command": "uvx",
      "args": [
        "atlassian-browser-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "atlassian-browser-mcp": {
      "command": "uvx",
      "args": [
        "atlassian-browser-mcp"
      ]
    }
  }
}
```

## Tools

- `atlassian_auth_status`: Reports whether each service's saved session exists and works.
- `atlassian_login`: Gives the atlassian-cli login command to show the user.

## FAQ

### Why not use an API token?

On SSO-protected Server or Data Center instances tokens are often unavailable.

### Does the server open a browser?

No. Login is a separate CLI step.

### Can I make it read-only?

Yes, set READ_ONLY_MODE=true.

### What does it require?

Python 3.11.5+, uv, Google Chrome and a display for the login.

### Is Atlassian (browser SSO) free?

Yes. Atlassian (browser SSO) is open source, so you can use and self-host it for free.

### How do I add Atlassian (browser SSO) to Claude Code?

Run this command in your terminal: claude mcp add atlassian-browser-mcp -- uvx atlassian-browser-mcp

### What are the best alternatives to Atlassian (browser SSO)?

The closest alternatives to Atlassian (browser SSO) are REA, Browser Use, Scrapling MCP Server, Context7 and Chrome DevTools MCP.

## 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.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [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.

---
Source: https://ai-powered.com/mcp/atlassian-browser-sso
