How to integrate Atlassian MCP with Hermes

Connect Hermes to Atlassian MCP. Create a jira issue for outage, list open jira issues assigned to me, and more using natural language, with authentication handled for you.

Atlassian MCP logoAtlassian MCP
Dcr Oauth

Atlassian Rovo MCP connects agents to Jira, Jira Service Management, Confluence, Bitbucket, Compass, and Teamwork Graph workflows. It lets teams surface and act on Atlassian data while respecting existing user permissions.

213 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Atlassian account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Atlassian MCP with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Atlassian with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Atlassian

Ask your agent to connect to Atlassian, or simply request any Atlassian-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Atlassian connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Atlassian or request any Atlassian-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Atlassian MCP server, and what's possible with it?

The Atlassian MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Atlassian account. It provides structured and secure access to Jira projects and issues, Confluence spaces and pages, Compass components, and Teamwork Graph context, so your agent can search work, create and update issues, publish Confluence pages, manage Compass components, and explore related context on your behalf.

  • Jira issue management: Have your agent create and edit Jira issues, add comments and worklogs, link related issues, and move work through available statuses.
  • Jira and Confluence search: Direct your agent to find issues, pages, and linked content with Rovo Search, or run targeted JQL and CQL searches when needed.
  • Confluence content and discussions: Let the agent create Confluence pages, browse spaces and child pages, read page content, and add inline or footer comments.
  • Compass component tracking: Instruct your agent to create and retrieve Compass components, define custom fields, and connect related components.
  • Connected work context: Have your agent explore relationships around Atlassian work, retrieve connected objects, and add relationships between items in the Teamwork Graph.

Way Forward

With Atlassian connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Atlassian MCP action and event your agent gets out of the box.

Addconfluencecontentpermissions

Adds one or more content-level permission grants to a single Confluence content entity.

Addconfluencereaction

Add emoji reaction to Confluence content

Addconnectionstogoals

Add one type of connection to one or more Atlassian Goals.

Addconnectionstoprojects

Add one type of connection to one or more Atlassian Projects.

Addgraphcontext

Adds a relationship between two entities in the Teamwork Graph (e.g.

Addlabelstoconfluencecontent

Add labels to any Confluence content (page, blogpost, attachment, custom content)

Addoreditjiraissuecomment

Add a comment to a Jira issue, or edit an existing one: omit commentId to add, or pass one from listJiraIssueComments to edit.

Addoreditjiraissueworklog

Log time spent on a Jira issue, or edit an existing worklog: omit worklogId to add, or pass one from listJiraIssueWorklogs to edit, which changes only the fields you pass.

Approvejsmrequestresolverplans

Approve the current Request Resolver plans for explicitly selected JSM issue keys after the user has reviewed their plans with getJsmRequestResolverPlans and confirmed approval.

Archiveconfluencecontent

Archive a single Confluence content entity

Atlassianuserinfo

Returns the accountId of the current user

Completeconfluencetask

Mark a Confluence inline task as complete

Convertconfluencecontentmode

Convert a Confluence page or live doc between classic page mode and live-doc mode

Convertjiraissuehierarchy

Convert an existing Jira issue across hierarchy levels: a standard issue (Task, Bug, Story) into a sub-task under a parent, or a sub-task back into a standard issue.

Copyconfluencecontent

Copy a Confluence page, whiteboard, database, folder, or embed to a new parent

Createartifactsupload

Step 1 of 2 for uploading a new artifact or a new version of an existing artifact.

Createartifactthumbnailupload

Create a thumbnail for an artifact using an image generated locally or supplied by the user.

Createcapacityplannonprojectwork

Create a non-project work item in Individual Capacity Planning.

Createconfluenceattachment

Prepare a Confluence attachment upload and return a local curl command

Createconfluencecomment

Create or reply to a comment on a Confluence page or blog post

Createconfluencecontent

Create a new Confluence page, blog post, live doc, whiteboard, database, embed, smart link, or folder.

Createconfluenceinfographicforpage

Create an infographic in a page workflow.

Createconfluencemauiapp

Create a Maui app in a page workflow.

Createconfluencespace

Create a Confluence space.

Createfocusarea

Create a new Focus area in a workspace.

Createfocusareastatusupdate

Create a status update on a focus area, or save it as a draft.

Creategoal

Create an Atlassian Goal or Success Measure using an enabled Goal Type.

Creategoalupdate

Create a progress update for an existing Atlassian Goal.

Createjiraboard

Create a new company-managed Jira Software board (scrum or kanban) from an existing filter.

Createjiraissue

Create a new Jira issue.

Createjiraissuelink

Create a link between two existing issues — blocks, duplicates, clones, relates.

Createjiraissueremoteissuelink

Create a native web link in a Jira issue's Web links section for a Confluence page or external HTTP(S) URL.

Createjsmrequest

Create a Jira Service Management customer-request work item using an explicit JSM service desk ID, JSM request type ID, and request field values.

Createloomfolder

Create a new folder in the current Loom workspace, optionally nested under a parent folder or placed in a space.

Createloomvideocomment

Post a comment on a Loom video, anchored to a specific point in the video.

Createloomvideoreaction

Add an emoji reaction to a Loom video, anchored to a specific point in the video.

Createloomvideoupload

Step 1 of 2 for uploading a new video to Loom.

Createproject

Create an Atlassian Project.

Createprojectupdate

Post a progress update on an existing Atlassian Project, or save it as an unposted draft with isDraft.

Createteam

Create an Atlassian team with a bounded name, optional description, MEMBER_INVITE or OPEN membership settings, and up to 50 initial account IDs.

Decidejsmrequestapproval

Approve or decline a pending approval on an existing Jira Service Management request.

Diffconfluencecontentversions

Compute a unified diff between two versions of a Confluence page, live doc, or blog post

Disableconfluencepubliclink

Disable the external public link (anonymous share) for a Confluence page

Downloadconfluenceattachment

Get a Confluence attachment download URL and return a local curl command

Downloadjiraissueattachment

Get a short-lived download URL for a Jira attachment and return a local downloadCommand.

Editconfluenceinfographicforpage

Edit an infographic in a page workflow.

Editconfluencemauiapp

Edit a Maui app in a page workflow.

Editjiraentityproperty

Sets a single property (technical key/value store) on a specific Jira entity (issue, issueComment, issueWorklog, dashboardItem, user), creating or overwriting it.

Editjiraissue

Edit an existing Jira issue.

Enableconfluencepubliclink

Enable the external public link (anonymous share) for a Confluence page

Exportconfluencecontent

Export Confluence content as PDF or Word and return a download link

Getaccessibleatlassianresources

Returns the cloudId(s) available to the current user

Getartifact

Get metadata for an artifact by ID.

Getassetsobject

Get an Assets object by ID from the selected site.

Getassetsobjectsbyid

Get one or more Assets objects by ID from the selected site.

Getassetsobjectschema

Get one or more Assets object schemas by ID from the selected site.

Getassetsobjecttype

Get one or more Assets object types by ID from the selected site.

Getassetsserviceobjectsbyid

Get one or more Assets service objects by ID from the selected site.

Getcapacityplanallocations

Find who is allocated to what work in Individual Capacity Planning, across ALL capacity plans - not scoped to a single plan.

Getcodefile

Read the full contents of a single file in a connected source-control repository at a specific commit.

Getconfluenceapproval

Get Confluence page approval availability, approval status, reviewers, and optional progress or history.

Getconfluenceattachment

Get Confluence attachment metadata by attachment ID

Getconfluencecomment

Get a single Confluence comment by ID

Getconfluencecontent

REQUIRED: Supply at least one content locator: content_id or content_url.

Getconfluencecontentanalytics

Return per-user Confluence viewer rows for one supported content item (page, live doc, or blog post), including each viewer's engagement category, the latest version viewed, and last viewed time.

Getconfluencecontentancestors

List the ancestor chain (parent, grandparent, …) of a Confluence content entity

Getconfluencecontentdescendants

List descendants of a Confluence content entity (page, folder, whiteboard, database, embed, or slide)

Getconfluencecontentpermissions

Lists the explicit content-level permission grants on a single Confluence content entity.

Getconfluencecontentrestrictionstate

Reads General access for a single Confluence content entity.

Getconfluencecontentstatus

Read the content state (status) of a Confluence page or blog post

Getconfluencecontentversion

Get one historical version of a Confluence page, live doc, or blog post

Getconfluencemauiapp

Retrieve the source and metadata for a Maui app owned by a Confluence page.

Getconfluencepersonalspace

Get the current user's Confluence personal space

Getconfluencepubliclinkstatus

Get the external public-link (anonymous share) status of a Confluence page

Getconfluencereactions

Get emoji reactions on Confluence content

Getconfluencespace

Get one Confluence space by id or key, including enabled content types, optional labels, and instructions when configured.

Getconfluencespaceinstructions

Get the space instructions for a Confluence space

Getconfluencetask

Get a single Confluence inline task by its ID

Getconfluencetemplate

Get a Confluence template body

Getcontentformatguide

Get the content-format guide for authoring a rich content body or constructing a Confluence Remix prompt.

Getfocusarea

Get a focus area by identifier, with optional expansions.

Getfocusareatypes

Get the configured Focus area type hierarchy for a workspace.

Getgoal

Retrieve one Atlassian Goal by its exact Goal ARI or key, with optional related details.

Getgoaltypes

Get the Goal Types available in an Atlassian site for creating Goals and Success Measures.

Getgoalupdate

Retrieve one Atlassian Goal update by its exact Goal Update ARI, with optional related details.

Getgraphcontext

Retrieves connected context from Teamwork Graph for any Atlassian entity.

Getgraphobject

Fetches the entire available data for one or more objects (Atlassian or third-party) using their ARIs or URLs.

Getjiraboardconfig

Returns the configuration for a Jira board; filter, column layout, and each column's mapped statuses with their id, name and category.

Getjiraboardissuedata

Get the issues on a Jira board, its backlog, or all of them, with optional count and JQL filtering.

Getjiraboardsprintdata

Resolve a Jira board plus its sprint data in one call.

Getjiracurrentuser

Get the calling user's own Jira profile.

Getjiraentityproperty

Returns a single property (technical key/value store) from a specific Jira entity (issue, issueComment, issueWorklog, dashboardItem, user), or lists all its property keys when propertyKey is omitted.

Getjiraissue

Get a Jira or JSM issue by key or ID.

Getjiraissuetypemetawithfields

Returns the schema and field metadata for a specific issue type in a project, useful for creating issues with correct fields.

Getjiraprojectversionrelatedwork

List the related work on a Jira project version (release): the designs, test plans, runbooks and change records teams attach to it.

Getjiraprojectversions

List a Jira project's releases/versions (pass projectIdOrKey), or fetch a single version (pass versionId) — provide exactly one.

Getjirauser

Get a Jira user's profile by account ID, including time zone, locale and active status, plus groups and application roles when asked for via expand.

Getjsmagentavailability

Read Jira Service Management Workforce Management availability for agents in a service project.

Getjsmopsalerts

Get one Jira Service Management Operations alert by ID or alias, or list and search alerts with optional query, time window, and pagination.

Getjsmopsscheduleinfo

Get Jira Service Management Operations schedule information: list schedules, get a specific schedule by ID, or retrieve current or next on-call responders for a schedule.

Getjsmopsteaminfo

Get Jira Service Management Operations team information: list all teams or get escalation policies for a specific team.

Getjsmrequest

Get details and the current customer-facing state of an existing Jira Service Management (JSM) customer request by issue key or ID.

Getjsmrequestactionmetadata

Discover customer-visible request-portal actions for an existing Jira Service Management request before a follow-up write.

Getjsmrequestcreationoptions

Prepare creation of a Jira Service Management customer-request work item for a project.

Getjsmrequestresolverplans

Retrieve a concise snapshot of Request Resolver plans for selected Jira Service Management requests by issue key or ID.

Getjsmrequesttypefields

Get field IDs, required flags, and allowed values for selected Jira Service Management work-item request type.

Getloomvideo

Reads a Loom video's core metadata and optionally its transcript, comments, AI agent briefs, AI-extracted meeting action items, or attached links in one call via the expand input.

Getloomvideodownloadurl

Get a time-limited signed URL to download the actual MP4 file of a Loom video.

Getmywork

Read the signed-in user's recent Jira, Confluence, Goals, Projects and Loom activity on one site.

Getproject

Retrieve one Atlassian Project by its exact Project ARI or key, with optional related details.

Getprojectupdate

Retrieve one Atlassian Project update by its exact Project Update ARI, with optional related details.

Gettalentfields

Discover the workspace's queryable Talent fields, or resolve the valid filter values for a specific field.

Gettalentgroupmetrics

Aggregate Talent positions into COUNTS grouped by one to four position field IDs — headcount by country, by status, by level, by job family, by manager, or any nesting of those.

Gettalentposition

Read a single Talent position by its ARI, returning its selected position field values and, optionally, field values for the worker filling it.

Gettalentpositionsbyentity

List the Talent positions attached to an entity — the direct reports of a manager position (entity=position with that manager's ARI as fieldValue), or the positions rolled up to a focus area (entity=focusArea).

Gettalentuser

Resolve the calling user's own place in the Talent workspace: their position entity ID, their manager's position entity ID, and their role.

Getteam

Get core metadata for one Atlassian team.

Linktofocusarea

Link one of either goals, work items, or sub-focus areas to a focus area.

Listartifacts

List artifacts created by the current user using cursor pagination.

Listassetsobjectschemas

List all Assets object schemas in the selected site's workspace.

Listassetsobjecttypeattributes

List attributes for one or more Assets object types in the selected site.

Listcapacityplannonprojectwork

Search the non-project work items on a site.

Listcodedirectory

List the files and subdirectories under a path in a connected source-control repository at a specific commit.

Listconfluenceattachments

List attachment metadata for a Confluence content item

Listconfluencecomments

List comments on a Confluence page or blog post

Listconfluencecontent

List Confluence content of one type within a single space (page, blog post, live doc, whiteboard, database, embed, smart link, folder, slide)

Listconfluencecontentversions

List version history for a Confluence page, live doc, or blog post, newest first

Listconfluencespaces

List Confluence spaces accessible to the caller

Listconfluencetasks

List Confluence inline tasks, optionally scoped to a page or blog post and filtered by status

Listconfluencetemplates

List Confluence templates and blueprints

Listjiraboards

List Jira boards visible to the current user.

Listjiraboardsprints

List a board's sprints — past, active or upcoming — or resolve a sprint name to the numeric sprintId that transitionJiraIssue and manageJiraSprint take.

Listjiradashboards

Returns Jira dashboards visible to the current user for discovery and linking workflows.

Listjirafilters

Search saved Jira filters visible to the current user, returning their IDs and JQL.

Listjiraissueassignableusers

List the users who can actually be assigned work in a project or on an issue.

Listjiraissuechangelogs

Get a Jira issue's field-change history — field edits only — paginated oldest-first with no ordering options.

Listjiraissuecomments

Get a paginated list of comments for a Jira issue.

Listjiraissuelinktypes

List the issue link types configured on this site, each with its name and its inward and outward wording (name "Blocks", inward "is blocked by", outward "blocks").

Listjiraissueremoteissuelinks

List the Confluence pages and external URLs linked from an issue's Web links section.

Listjiraissuetransitions

List the workflow transitions this issue can take right now, for the calling user.

Listjiraissueworklogs

Get a paginated list of worklogs (logged time) for a Jira issue.

Listjiraprojectcomponents

List a Jira project's components with their ids, names, lead and assignee settings, and issueCount — 0 means no issues use a Jira component; Compass results list only components already linked to issues.

Listjiraprojectissuetypesmetadata

Returns all issue types available in a Jira project, useful for knowing which issue types can be created.

Listjiraprojects

Find the Jira projects the calling user can see — use it to resolve the projectKey that createJiraIssue requires, or the project a JQL search filters on.

Listjirastatuses

List the statuses a Jira issue can be in — for a project (per work type), for one status looked up by ID or name, or across the whole site by name or category.

Listloomfolders

List the folders in the current Loom workspace that a video can be moved into, returning each folder's id, name, and parent space.

Listloomvideos

List the Loom videos you own (that you created), most recent first.

Listloomvideossharedwithme

List the Loom videos that other people have shared with you, most recent first.

Lookupjiraaccountid

Look up a Jira user account ID by display name or email — skip it if you already have the accountId.

Manageconfluenceapproval

Request, decide, cancel, clear, or update a Confluence page approval.

Managejiraprojectversion

Create, update, release, or archive a Jira project version (release or fix version).

Managejiraprojectversionrelatedwork

Create or update related work links on a Jira project version (release).

Managejirasprint

Create, add issues to, start, update, or close a Jira sprint; get a sprintId from listJiraBoardSprints.

Moveconfluencecontent

Move a Confluence page, whiteboard, database, folder, or embed to a new parent or sibling position

Moveloomvideotofolder

Move a Loom video into a folder in the current workspace.

Publishartifact

Step 2 of 2 for uploading an artifact.

Publishloomvideo

Step 2 of 2 for uploading a new video to Loom.

Queryassetsobjects

Query Assets objects with generated AQL for one object type in the selected site.

Queryassetsobjectschemaattributes

Query attributes for one or more Assets object schemas in the selected site.

Queryassetsobjectsusingaql

Query Assets objects with raw or generated AQL in the selected site.

Queryassetsobjecttypes

Query Assets object types by schema in the selected site.

Queryassetsreferencetypes

Query global or schema-scoped Assets reference types in the selected site.

Recoverloomvideo

Recover a Loom video that failed to process, by initiating a recovery job to re-process it.

Removeconfluencecontentpermissions

Removes content-level permission grants from a single Confluence content entity.

Reopenconfluencetask

Reopen a completed Confluence inline task (mark it incomplete)

Replaceconfluencecontentpermissions

Replaces ALL content-level permission grants on a single Confluence content entity with the supplied set.

Resolveconfluencecontentmacros

Resolve supported Confluence macro wrappers into per-macro HTML displayed in Confluence web.

Restoreconfluencecontentversion

Restore an earlier version of a Confluence page, live doc, or blog post as a new latest version

Revokeartifactshare

Stop sharing an artifact with named users, groups, or teams, or with every audience at once.

Scancoderepo

List the file paths in a connected source-control repository at a specific commit, optionally filtered by a glob or restricted to a subtree.

Search

Semantically search Jira, Confluence, and connected third-party content using Rovo Search.

Searchassetsobjects

Search Assets objects by name or query-builder filters in the selected site.

Searchcode

Search source code across connected source-control providers using semantic, lexical, or hybrid matching.

Searchconfluence

Search Confluence content with CQL

Searchfocusareas

Search focus areas using text and structured filters with optional pagination and sorting.

Searchgoals

Find Atlassian Goals by text and structured filters.

Searchjiraissuesusingjql

Search for Jira issues using JQL, with an optional approximate count.

Searchjsmrequests

Search one bounded page of caller-visible Jira Service Management requests.

Searchprojects

Find Atlassian Projects by text and structured filters.

Searchtalentpositions

Search Talent positions by their own attributes using an RQL filter, returning a paginated list of positions with their requested field values (each position's ARI is the `id`, so this is how you obtain ARIs for getTalentPosition).

Searchteams

Search Atlassian teams by name with cursor pagination.

Setconfluencecontentrestrictionstate

Sets the high-level restriction state for a single Confluence content entity.

Setconfluencecontentstatus

Set the content state (status) of a Confluence page or blog post

Setconfluencespaceinstructions

Set the space instructions for a Confluence space

Setjsmagentavailability

Set one Jira Service Management Workforce Management agent's availability for a service project.

Shareartifact

Grant named users, groups, or teams permission to view an existing artifact.

Shareloomvideo

Share a Loom video with one or more specific Atlassian users by sending them a notification (with an optional message).

Starconfluencecontent

Star a Confluence content item for the current user

Starconfluencespace

Star a Confluence space for the current user

Transitionjiraissue

Move a Jira issue through its workflow and/or into a sprint or the backlog — at least one is required.

Transitionjsmrequest

Perform one customer/request-portal-visible Jira Service Management request transition selected from getJsmRequestActionMetadata.

Unarchiveconfluencecontent

Unarchive (restore) a single Confluence content entity

Unstarconfluencecontent

Remove a star from a Confluence content item for the current user

Unstarconfluencespace

Remove a star from a Confluence space for the current user

Unwatchconfluencecontent

Stop watching a Confluence content item for the current user

Unwatchconfluencelabel

Stop watching a Confluence label for the current user

Unwatchconfluencespace

Stop watching a Confluence space for the current user

Updatecapacityplanallocations

Allocate people to a single work item over one or more time periods in Individual Capacity Planning.

Updatecapacityplannonprojectwork

Rename an existing non-project work item in Individual Capacity Planning.

Updateconfluencecomment

Update an existing Confluence footer or inline comment on a page or blog post

Updateconfluencecommentresolution

Resolve or reopen a Confluence footer or inline comment

Updateconfluencecontent

Update Confluence docs, whiteboards, or databases.

Updatefocusarea

Update one or more fields on an existing Focus area.

Updatejsmopsalert

Update one Jira Service Management Operations alert by acknowledging, unacknowledging, closing, or escalating it.

Updateloomvideopermissions

Change who can access a Loom video by setting its visibility to OWNER (only you), WORKSPACE (anyone in your workspace), or PUBLIC (anyone with the link).

Updateloomvideotitle

Rename a Loom video.

Updatetalentpositionfocusareamappings

Allocate Talent positions to focus areas, or clear the focus area a position is allocated to.

Updateteam

Update one Atlassian team through exactly one operation.

Uploadattachmenttojiraissue

Attach a single local file to a Jira issue.

Watchconfluencecontent

Start watching a Confluence content item for the current user

Watchconfluencelabel

Start watching a Confluence label for the current user

Watchconfluencespace

Start watching a Confluence space for the current user

Watchjiraissue

Add or remove the calling user as a watcher on a Jira issue.

FAQ

Frequently asked questions

Start with Atlassian MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Atlassian MCP tool your agent needs.Free to start.

Start building