Search DevTools

Jump to any tool or page

Atlassian Rovo MCP Server

Trending

Connect to Atlassian Jira, Confluence, and Compass to search, create, and manage your work.

atlassian982 stars123 forksAI & Agents
View source

Install

mcp_config.json

{
  "mcpServers": {
    "com-atlassian-atlassian-mcp-server": {
      "url": "https://mcp.atlassian.com/v1/mcp",
      "type": "streamable-http"
    }
  }
}

Documentation

Atlassian Rovo MCP Server

The official Model Context Protocol (MCP) server for Atlassian: a cloud-hosted bridge that gives your AI tools secure, real-time access to Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom, and the wider Atlassian platform — powered by your Teamwork Graph.

Getting started · Supported tools · Security & admin · Community


The official Atlassian Rovo MCP Server is a cloud-based bridge between your Atlassian Cloud site and compatible external tools. Once configured, it enables those tools to interact with Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom, and Atlassian platform data (Projects, Goals, Teams, Focus, Talent, and the Teamwork Graph) in real time. Authentication uses OAuth 2.1 or API tokens, so every action respects the user's existing access controls.

With the Atlassian Rovo MCP Server, you can:

  • Summarize and search Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals, and more without switching tools.
  • Retrieve and review recordings of videos and meetings from Loom.
  • Create and update work items or pages based on natural language commands.
  • Automate repetitive work, like generating work items from meeting notes or specs.

Connect once, then describe what you want — no tab switching and no copy-pasting. Your AI selects and runs the right actions.

It's built for developers, content creators, and project teams who work in IDEs or AI tools and want to use Atlassian data without constantly switching context.

[!IMPORTANT] v2 is now the recommended version. New setups should use https://mcp.atlassian.com/v2/mcp, which exposes more tools and more products. Existing v1 connections automatically start to expose and use v2 tools; incompatible clients may need to clear cached client IDs or .well-known credentials to keep authenticating. For setup steps, see Getting started with the Atlassian Rovo MCP Server.

One-click setup

Pick your AI client below to install the official Atlassian Rovo MCP Server. Each button uses your client's native install link, so you don't need to edit any JSON config by hand.

    Add to Cursor
  
  Reference issues and log work in your codebase.


  
    
    Add to VS Code
  
  Search and create Jira issues via GitHub Copilot.


  
    
    Add to ChatGPT
  
  Search, summarize, and create right from ChatGPT.


  
    
    Add to Claude
  
  Bring Jira and Confluence into Claude workflows.

Let your agent do the setup

Most AI coding agents can install, authenticate, and configure the server themselves. Copy and paste this prompt into your agent:

Set up Atlassian Rovo MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.

Or add the server manually with your client's own command:

ClientCommand or configuration
Claude Codeclaude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, then run /mcp in a session to authenticate
Codexcodex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp
Claude DesktopSettings → Extensions → Browse extensions → Plugins, then search for Atlassian
Codex DesktopPlugins or Connectors, then install Atlassian Rovo
VS Code / GitHub CopilotExtensions view → search @mcp AtlassianInstall
CursorAtlassian plugin for Cursor with MCPAdd to Cursor
WindsurfCascade → MCP servers → Add Server → Add custom server, with serverUrl set to https://mcp.atlassian.com/v2/mcp
Any other MCP clientUse the server URL https://mcp.atlassian.com/v2/mcp

Contents


Supported clients

The Atlassian Rovo MCP Server works with a growing list of MCP-compatible clients:

ClientSetup reference
OpenAI ChatGPTConnectors / MCP guide
OpenAI Codex (CLI and Desktop)Codex MCP docs
Claude (Claude.ai, Desktop, and Code)Claude MCP docs
CursorAtlassian on the Cursor marketplace
Visual Studio Code (GitHub Copilot)VS Code MCP docs
GitHub Copilot CLIAbout Copilot CLI
Google Gemini CLIGemini CLI MCP docs
WindsurfWindsurf MCP docs
DockerDocker MCP Catalog and Toolkit
Kiro and other Agent Plugins clientsKiro Powers documentation
Amazon Quick SuiteMCP integration guide

The Atlassian Rovo MCP Server also supports any local MCP-compatible client that can run on localhost and connect to the server via the mcp-remote proxy. This enables custom or third-party integrations that follow the MCP specification.

[!TIP] For the current, canonical list of supported clients and step-by-step setup, see Getting started with the Atlassian Rovo MCP Server. You can also refer to your client's own MCP documentation or built-in assistant.


Plugin packaging and compatibility

This repository publishes the same MCP server and skills in several package formats so clients can use their native discovery and installation flows:

FormatManifest and configurationShared components
Agent Plugins v1plugin.json and mcp.jsonskills/
Claude Code plugin.claude-plugin/plugin.json and .claude-plugin/marketplace.json.mcp.json and skills/
Cursor plugin.cursor-plugin/plugin.json.mcp.json and skills/
Gemini extensiongemini-extension.jsonMCP server configuration embedded in the manifest
MCP Registryserver.jsonRemote server metadata

The skills in skills/ target the /v2/mcp endpoint and are what every packaged plugin installs. The previous generation is archived in skills/v1/ for anyone still on a v1 endpoint; it is not installed by any plugin and is set up manually. See skills/README.md for the differences.

Both mcp.json and .mcp.json are intentional. Agent Plugins requires the root mcp.json filename and its portable transport vocabulary; existing clients continue to use .mcp.json and their native configuration vocabulary. Keep their endpoint settings aligned when changing either file.

The root package can be imported by clients that implement Agent Plugins, including Kiro Powers. Client-specific manifests remain available and are not replaced by the portable package.


Supported products and tools

Tools are organized by product and intent (read, write, search, delete, or manage). Organization admins grant or revoke access at the permission-group level, and each tool inherits the access of its parent group.

ProductPermission groupsOAuth 2.1API token
Jiraread_jira · write_jira · search_jira
Jira (admin-enabled)delete_jira · manage_jira
Confluenceread_confluence · write_confluence · search_confluence
Bitbucket Cloudread_bitbucket · write_bitbucket
Jira Service Managementread_jsm · write_jsm✅ (only)
Atlassian platformread_teamwork_graph · write_teamwork_graph · search_atlassian
Loomread_loom · write_loom
Goalsread_goals · write_goals
Projectsread_projects · write_projects
Teamsread_teams · write_teams
Focusread_focus · write_focus
Talentread_talent · write_talent
Compassread_compass · write_compass✅ (only)

Product-specific conditions:

  • delete_jira and manage_jira are disabled by default and must be enabled by an admin before they can be used.
  • Bitbucket Cloud tools are only available if your Bitbucket workspace is linked to an organization. Workspaces that aren't linked to an organization can't be selected when authenticating.
  • Jira Service Management tools only support authentication via API token, and are only available if an organization admin has enabled API token authentication.
  • Loom tools are only available for Loom workspaces linked to an Atlassian site.
  • Teamwork Graph tools can retrieve data from third-party services connected to Jira, such as linked pull requests, builds, and deployments. For GitHub for Atlassian, full access means tools retrieve GitHub data based on the user's GitHub permissions, while limited access means they retrieve data based on the user's Jira permissions. Azure DevOps, GitLab, Jenkins, and Spinnaker connectors follow the limited access model.

[!NOTE] For the complete, current tool reference, including the required scope for each permission group, see Supported tools.


How the server exposes tools

Rather than sending every tool definition to the AI client at connection time, the Atlassian Rovo MCP Server exposes a small set of the most-used tools and lets the client discover the rest on demand. Tools marked Primary are visible directly to agents.

This has two benefits:

  • Your client's context stays free for the task at hand instead of being filled with tool definitions.
  • New tools become available without the client needing to reconnect.

MCP gateways

If you're using an MCP gateway, or otherwise need every tool available up front rather than using the discovery and execute methods, use the tools=all override to expose all tools as a paginated flat tool list:

https://mcp.atlassian.com/v2/mcp?tools=all

Before you start

Check that your environment meets these requirements before you set up the server.

Prerequisites

The requirements depend on how you connect:

For supported clients
  • An Atlassian Cloud site with one or more of Jira, Confluence, Jira Service Management, Bitbucket, or Compass
  • Access to the client of choice
  • A modern browser to complete the OAuth 2.1 authorization flow, or API token credentials for headless authentication

If your organization admin ha

Sourced from the repository README.

More in AI & Agents