Atlassian

You run a MCP server that exposes Atlassian Confluence and Jira tools to automate workspace tasks. It supports 51 tools across Confluence and Jira, and you can deploy it via npm-based CLI, global CLI, or Docker. This server lets you build AI-assisted automations for content management, issue handling, sprint planning, boards, backlogs, and more, with flexible configuration and secure token-based access.

How to use

You interact with the MCP server through your chosen MCP client. Start the server in one of the supported deployment modes, then point your client to the server, supplying your Atlassian domain, account email, and API token. Use the client to invoke any of the 51 available tools to manage spaces, pages, issues, sprints, boards, backlogs, and epics. For example, list Confluence spaces, search pages with CQL, create a page, or manage Jira issues and sprints. The tools are designed to be invoked by name with structured parameters, and you can combine multiple actions into automated workflows.

How to install

Prerequisites: ensure Node.js and npm are installed on your machine, or have bun installed if you prefer bun-based workflows. You can also run the server via Docker. Follow one of the deployment methods below.

# Method 1: Using npx (recommended, no installation required)
npx @xuandev/atlassian-mcp
npx @xuandev/atlassian-mcp --config /path/to/config.json
ATLASSIAN_DOMAIN="your-domain.atlassian.net" ATLASSIAN_EMAIL="your-email@example.com" ATLASSIAN_API_TOKEN="your-api-token" \
npx @xuandev/atlassian-mcp

# Method 2: Global installation
npm install -g @xuandev/atlassian-mcp
atlassian-mcp --domain your-domain.atlassian.net --email your-email@example.com --token your-api-token

# Method 3: Docker (Containerized Deployment)
docker pull xuanxdev/atlassian-mcp:latest
docker run -i --rm \
  -v .atlassian-mcp.json:/config/.atlassian-mcp.json:ro \
  xuanxdev/atlassian-mcp:latest

# Run with environment variables
docker run -i --rm \
  -e ATLASSIAN_DOMAIN="your-domain.atlassian.net" \
  -e ATLASSIAN_EMAIL="your-email@example.com" \
  -e ATLASSIAN_API_TOKEN="your-api-token" \
  xuanxdev/atlassian-mcp:latest

Configuration

Configure this MCP server by providing your Atlassian domain, account email, and API token. You can supply these values via a config file, environment variables, or command-line arguments. The recommended approach is to use a config file at ~/.atlassian-mcp.json or a config path you specify.

Configuration options include: domain, email, and apiToken. For security, protect your config file with restricted permissions.

Config file example (JSON):

{
  "domain": "your-domain.atlassian.net",
  "email": "your-email@example.com",
  "apiToken": "your-api-token-here"
}

Security and tokens

Create an API token from Atlassian and copy it securely. Treat the token like a password and do not expose it in client code or logs. Use restrictive permissions on your config file.

Notes and troubleshooting

If you encounter authentication errors, verify that your Atlassian domain, email, and API token are correct and that the API token has the necessary scopes for Confluence and Jira operations.

Available tools

confluence_list_spaces

List all Confluence spaces with optional pagination control.

confluence_search

Search Confluence content using CQL with optional expansion fields.

confluence_list_pages

List pages within a Confluence space with pagination.

confluence_get_page

Retrieve detailed information about a Confluence page, including content and metadata.

confluence_get_page_children

Fetch child pages for a given page to explore hierarchy.

confluence_create_page

Create a new Confluence page with optional parent-child placement.

confluence_update_page

Update an existing Confluence page with new content or title.

confluence_delete_page

Delete a Confluence page, moving it to trash for potential restoration.

confluence_search_user

Search Confluence users by name or email for access control.

confluence_get_labels

Get labels attached to a page for tagging and organization.

confluence_add_label

Add a label to a Confluence page, creating it if necessary.

confluence_get_comments

Retrieve comments on a Confluence page.

confluence_add_comment

Add a comment to a Confluence page, supporting threaded replies.

jira_list_projects

List all accessible Jira projects with relevant metadata.

jira_search_issues

Query Jira issues using JQL with optional field filtering.

jira_get_issue

Get a specific Jira issue with selected fields and expansions.

jira_get_project_issues

Retrieve all issues for a given Jira project.

jira_create_issue

Create a new Jira issue with support for multiple types and custom fields.

jira_update_issue

Update a Jira issue with changes to specified fields, preserving others.

jira_delete_issue

Delete a Jira issue, with optional deletion of subtasks.

jira_get_transitions

List available transitions for an issue to guide state changes.

jira_transition_issue

Move an issue through its workflow by applying a transition.

jira_add_comment

Add a comment to a Jira issue, with Jira markdown support.

jira_get_worklog

Retrieve work logs for an issue to track time spent.

jira_add_worklog

Log work time against an issue with optional start time and description.

jira_get_issue_link_types

Get available issue link types for relationships between issues.

jira_create_issue_link

Create a link between two Jira issues with an optional comment.

jira_remove_issue_link

Remove an existing link between two issues.

jira_get_project_versions

List all project versions/releases with details.

jira_create_version

Create a new project version or release.

jira_batch_create_versions

Create multiple versions in a single operation.

jira_search_fields

Search and list Jira fields, including custom fields.

jira_get_user_profile

Fetch detailed Jira user profile information.

jira_get_agile_boards

List agile boards (Scrum/Kanban) with filters.

jira_create_board

Create a new Scrum or Kanban board for a project.

jira_update_board

Update board configuration with limited support for changes.

jira_delete_board

Permanently delete a board and its configuration.

jira_get_board_issues

Fetch all issues on a board with optional JQL filters.

jira_get_backlog_issues

List backlog issues not assigned to any sprint.

jira_rank_backlog_issues

Rank or reorder backlog issues to prioritize work.

jira_get_sprints_from_board

List sprints for a Scrum board with state filtering.

jira_get_sprint_issues

Get all issues within a specific sprint.

jira_create_sprint

Create a new sprint on a board with optional dates and goal.

jira_update_sprint

Update sprint details or state, including starting or closing.

jira_delete_sprint

Delete a sprint that has not started yet.

jira_move_issues_to_sprint

Move backlog issues into a sprint to prepare for planning.

jira_link_to_epic

Link an issue to an Epic to organize features.

jira_get_epic_issues

List all issues that belong to a specific Epic.

jira_batch_create_issues

Create multiple Jira issues in a single operation.

jira_batch_get_changelogs

Retrieve change history for multiple issues to audit progress.

jira_download_attachments

Get metadata and download URLs for issue attachments.