sooperset/mcp-atlassian
Mcp Atlassian
mcp-atlassian is a tool that connects Atlassian project data to AI assistants using the Model Context Protocol. It provides a standardized tool-calling interface that enables AI assistants to interact directly with project data and documentation.
The project supports multi-tenant environments and diverse hosting scenarios, including cloud and on-premise deployments. It implements multiple authentication methods such as OAuth 2.0, API tokens, and personal access tokens, and can route traffic through configurable HTTP, HTTPS, or SOCKS proxies to meet corporate security requirements.
Its capabilities cover comprehensive project management, including issue tracking, agile board and sprint management, and development activity tracking. It also provides extensive knowledge management features for page creation, documentation search, and bidirectional linking between tasks and wiki pages. Additionally, it includes observability tools for auditing change history and calculating SLA-aware lead and cycle times.
The server can be deployed as a container image via Docker or run as a persistent HTTP service.
Features
- Atlassian Servers - Connects AI assistants to Jira and Confluence for project management and documentation tasks via MCP.
- Issue Tracking - Creates new issues in Jira projects by providing summary, description, and issue type.
- Issue Creation Tools - Creates new Jira issues with specified fields, assignee, description, and optional epic or parent links.
- Structured Query Engines - Powers the core search and retrieval capabilities for Jira and Confluence data.
- Confluence Managers - Creates, reads, updates, and searches Confluence pages with Markdown support through an MCP tool.
- CQL Searches - Searches Confluence pages and content using Confluence Query Language (CQL) to find relevant documentation.
- Confluence Page Creators - Creates Confluence pages with Markdown or wiki content in specified spaces.
- Full Lifecycle Managers - Provides full CRUD lifecycle for Confluence pages including moves, comparisons, and version history.
- Markdown-to-Document Conversion - Translates Markdown into Atlassian Document Format or wiki markup for content creation.
- Atlassian Document Format Converters - Converts Markdown to Atlassian Document Format or wiki markup for platform compatibility.
- Page Content Retrievals - Retrieves Confluence page content by ID or title and space key for AI processing.
- Page Content Updates - Modifies existing Confluence page titles, content, parent, or emoji with version comments.
- Page Creations - Creates new Confluence pages with specified titles and content via an AI interface.
- Full Lifecycle Managers - Creates, searches, and manages Confluence pages, comments, labels, and attachments with version history.
- Jira Connectors - Modifies existing Jira issues including fields, status, components, and attachments.
- Full Lifecycle Managers - Creates, reads, updates, and transitions Jira issues with comments, attachments, and worklogs.
- Atlassian Instance Routers - Routes requests to multiple Atlassian cloud instances with per-request authentication and isolated data access.
- Issue Management Utilities - Provides full lifecycle management of Jira issues including creation, updates, and status transitions.
- Jira Managers - Creates, updates, searches, and transitions Jira issues with full lifecycle management through an MCP tool.
- Sprint Management - Manages Jira sprints, boards, and backlog items with full sprint lifecycle operations.
- General JQL Queries - Queries Jira issues using Jira Query Language with filters, pagination, and field selection to find relevant project items.
- Client Connections - Provides the primary interface for AI assistants to connect to Atlassian data via MCP.
- Atlassian Deployments - Connects to both Atlassian Cloud and Server/Data Center, handling authentication and API differences automatically.
- MCP HTTP Servers - Runs the MCP server as a persistent HTTP service for remote and multi-user deployments.
- Atlassian API - Configures connection details for Jira and Confluence API access.
- MCP Transport Protocol Supports - Selects between stdio, SSE, and streamable HTTP transports for MCP server connectivity.
- Externally Managed Bearer Token Authenticators - Supports authentication via externally managed bearer tokens for multi-tenant setups.
- OAuth 2.0 Authorization Flows - Runs OAuth 2.0 three-legged flow with scoped permissions and automatic token refresh for cloud deployments.
- OAuth Authentication - Activates OAuth proxy with Dynamic Client Registration and well-known discovery routes for secure access.
- Token Authentication - Uses personal access tokens from Server or Data Center user profiles for authentication.
- Atlassian API Token Authenticators - Provides API token authentication for connecting to Atlassian Cloud services.
- Agile Project Management - Manages Jira boards, sprints, and agile project management structures through an MCP interface.
- Jira Implementations - Manages Jira sprints, boards, and agile project workflows through an MCP tool interface.
- Issue Detail Retrievers - Retrieves detailed information about specific Jira issues including fields, comments, and related links.
- Issue Search - Searches Jira projects and issues using JQL or natural language to find relevant tickets.
- MCP Tool Allow Lists - Controls which MCP tools are available via allow lists or groups.
- SSE Transports - Streams real-time MCP events over Server-Sent Events for remote client connections.
- Change History Retrievers - Retrieves changelogs for multiple Jira issues at once, optionally filtered by specific fields.
- Issue Date Retrievals - Return date information and status transition history for a Jira issue.
- Time Tracking Integrations - Records time spent on Jira issues with optional start time and remaining estimate adjustments.
- Confluence Content Labelers - Labels Confluence content for organization and retrieval.
- SLA Metric Calculations - Computes cycle time, lead time, and other SLA metrics from issue changelog data.
- Comprehensive - Computes cycle time, lead time, time in status, due date compliance, resolution time, and first response time from issue changelog data.
- Worklog Retrievals - Fetches all logged time entries for Jira issues to review effort spent.
- Confluence Page - Fetches all comments for a Confluence page by ID.
- Plain Text Searches - Passes natural language text to Confluence's siteSearch for relevance-ranked results without writing CQL.
- Tenant Request Routing - Routes requests to the correct Atlassian instance using per-request authentication headers.
- Confluence Content Searches - Accepts plain text or CQL queries to find Confluence pages, spaces, and content with configurable result limits and space filters.
- JQL Date Filters - Compares issue creation, update, or resolution dates using relative or absolute date expressions and date-related functions.
- Structured Comment Management - Adds, replies to, and retrieves comments and labels on pages.
- Issue Commenting - Posts Markdown-formatted comments to Jira issues with optional role-based visibility restrictions.
- Markdown Comment Converters - Posts Markdown-formatted comments to Confluence pages.
- OAuth Client Registrations - Enables MCP clients to onboard users through standard OAuth discovery and registration flows.
- JQL Board Issue Queries - Retrieves issues from Jira boards filtered by JQL queries with field selection.
- User-Based JQL Filters - Filters issues by the current user, reporter, or assignee using user-related fields and the currentUser() function.
- Board Search Utilities - Searches Jira boards by name, project key, or type with fuzzy matching and pagination.
- VCS-Issue Linking - Retrieves linked pull requests, commits, and branches for a single Jira issue.
- MCP Server HTTP Services - Enables remote deployment of the MCP server as a persistent HTTP service.
- Issue Attachment Downloads - Downloads attachments from Jira issues as base64-encoded content with size limits.
- Environment Variable Scope Filters - Restricts server access to specific projects and spaces via environment variable filters.
- Request-Level Routers - Routes each request to the correct Atlassian cloud instance using per-request authentication headers.
- MCP Client Onboarding - Enables secure user onboarding through OAuth discovery and dynamic client registration for MCP clients.
- Atlassian Integrations - Connects AI assistants to multiple Atlassian cloud instances with per-request authentication and isolated data access.
- Discovery Endpoint Exposures - Exposes OAuth discovery and registration endpoints for spec-aligned client onboarding.
- Proxy-Based Onboarding Flows - Provides OAuth proxy with discovery and registration endpoints for secure client onboarding.
- Per-Request Credential Handlers - Enables multi-tenant operation by accepting per-request authentication for isolated data access.
- Issue Metadata Timestamps - Returns creation, resolution, due dates, and status transition timestamps for a Jira issue.
- Issue Linking Utilities - Creates relationships between issues, links to epics, and manages project versions and components.
- Confluence Content Label Retrievals - Retrieves labels from Confluence content for categorization.
- Confluence - Manages file attachments on Confluence pages with full lifecycle support.
- Confluence Comment and Label Managers - Manages comments and labels on Confluence pages programmatically.
- Confluence Threaded Comment Replies - Posts threaded replies to comments on Confluence pages.
- Model Context Protocol - MCP server for Atlassian tool integration.
- Communication - Integration with Confluence and Jira.
- Media and Communication - Atlassian suite communication integration.
- Productivity and Workflow Integration - Manages Atlassian products including Confluence and Jira.
