MCP Atlassian
An MCP server for Jira and Confluence, cloud and self-hosted: search, create and edit issues and pages
Install
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"JIRA_URL": "https://your-company.atlassian.net",
"JIRA_USERNAME": "your.email@company.com",
"JIRA_API_TOKEN": "your_api_token",
"CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
"CONFLUENCE_USERNAME": "your.email@company.com",
"CONFLUENCE_API_TOKEN": "your_api_token"
}
}
}
}For Server/Data Center use JIRA_PERSONAL_TOKEN instead of JIRA_USERNAME and JIRA_API_TOKEN.
This is third-party code. Review the repository files before installing.
What it does
The server connects the agent to Jira and Confluence. The agent searches issues with JQL and pages with CQL, reads, creates and updates them, transitions statuses and adds comments. It supports Atlassian Cloud and Server/Data Center: Confluence 6.0+ and Jira 8.14+. Auth is via API token, personal access token or OAuth 2.0, and an HTTP mode serves multiple users.
Who it is for. For teams that track work in Jira and document in Confluence.
Good fit when
- You need your issues or a project report from Jira
- You need to file a bug from a chat description
- You need to find or update a Confluence page
Not a fit when
- The team uses Yandex Tracker or another tracker
- The token grants more rights than the agent should have and cannot be scoped
Example request
Find issues assigned to me in PROJ and move PROJ-123 to DoneLimitations
Requires an Atlassian API token or a personal access token for Server/Data Center. Atlassian Cloud restricted service for users in Russia, so cloud instances may be unreachable; a self-hosted Jira or Confluence in your network works. Not an official Atlassian product.
How to disable. Remove the mcp-atlassian block from the MCP config and revoke the API token in Atlassian settings.
MCP
- Transport
- stdio, sse, http
- Authentication
- API key
| Environment variables | |
|---|---|
| JIRA_URL | Jira URL |
| JIRA_USERNAME | Jira Cloud user email |
| JIRA_API_TOKEN secret | Jira Cloud API token |
| JIRA_PERSONAL_TOKEN secret | Personal access token for Jira Server/Data Center |
| CONFLUENCE_URL | Confluence URL |
| CONFLUENCE_USERNAME | Confluence Cloud user email |
| CONFLUENCE_API_TOKEN secret | Confluence Cloud API token |
Security check
- Creates and edits issues and pages in an external system
- Holds API tokens with user-level rights
README in short
The README is a quick start: get a token, add a config with uvx and environment variables, start asking. Details live on the docs site: install via uvx, Docker and pip, auth options, HTTP transport and the tool reference. It includes a compatibility table and the key Jira and Confluence tools. MIT licensed.
FAQ
Does it work with self-hosted Jira?
Yes, Server and Data Center are supported with personal access tokens.
Can I connect only Jira?
Yes, set only the Jira variables.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search