mcpField
M
MCP Atlassian

MCP Atlassian

Local
mcp-atlassian.soomiles.comVersion Control6.1kUpdated 6w ago
RepositoryVisit website

About MCP Atlassian

MCP Atlassian is an MCP server for Confluence and Jira that supports both Cloud and Server/Data Center deployments. It is aimed at teams and individuals who want AI assistants to query, create, and update Atlassian content directly.

Key features

  1. 01Search, create, update, and transition Jira issues
  2. 02Search, read, create, and update Confluence pages
  3. 03API token and personal access token authentication
  4. 04Cloud and Server/Data Center support

Use cases

  1. 01Finding issues assigned to you using natural language
  2. 02Searching Confluence documentation
  3. 03Creating bug tickets or changing issue status through an AI assistant

MCP support

The project is an MCP server that exposes about 98 Jira and Confluence tools, such as jira_search and confluence_search, to MCP clients.

#jira#mcp#confluence#atlassian

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USERNAME": "<JIRA_USERNAME>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "CONFLUENCE_URL": "<CONFLUENCE_URL>",
        "CONFLUENCE_USERNAME": "<CONFLUENCE_USERNAME>",
        "CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>"
      }
    }
  }
}
Run commanduvx mcp-atlassian
Environment variables to set
JIRA_URL
JIRA_USERNAME
JIRA_API_TOKENSecret
CONFLUENCE_URL
CONFLUENCE_USERNAME
CONFLUENCE_API_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-atlassian

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

MCP Atlassian

PyPI Version PyPI - Downloads PePy - Total Downloads Run Tests License Docs

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Confluence Demo

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Quick Start

1. Get Your API Token

Go to https://id.atlassian.com/manage-profile/security/api-tokens and create a token.

For Server/Data Center, use a Personal Access Token instead. See Authentication.

2. Configure Your IDE

Add to your Claude Desktop or Cursor MCP configuration:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center users: Use JIRA_PERSONAL_TOKEN instead of JIRA_USERNAME + JIRA_API_TOKEN. See Authentication for details.

Autohand Code

Use the same uvx server with your Atlassian credentials:

autohand mcp add mcp-atlassian env \
  JIRA_URL=https://your-company.atlassian.net \
  [email protected] \
  JIRA_API_TOKEN=your_api_token \
  CONFLUENCE_URL=https://your-company.atlassian.net/wiki \
  [email protected] \
  CONFLUENCE_API_TOKEN=your_api_token \
  uvx mcp-atlassian

Add --scope project after add to keep the configuration in the current project. See Autohand Code for current installation and CLI details.

3. Start Using

Ask your AI assistant to:

  • "Find issues assigned to me in PROJ project"
  • "Search Confluence for onboarding docs"
  • "Create a bug ticket for the login issue"
  • "Update the status of PROJ-123 to Done"

Documentation

Full documentation is available at mcp-atlassian.soomiles.com.

Documentation is also available in llms.txt format, which LLMs can consume easily:

TopicDescription
Installationuvx, Docker, pip, from source
AuthenticationAPI tokens, PAT, OAuth 2.0
ConfigurationIDE setup, environment variables
HTTP TransportSSE, streamable-http, multi-user
Tools ReferenceAll Jira & Confluence tools
TroubleshootingCommon issues & debugging

Compatibility

ProductDeploymentSupport
ConfluenceCloudFully supported
ConfluenceServer/Data CenterSupported (v6.0+)
JiraCloudFully supported
JiraServer/Data CenterSupported (v8.14+)

Key Tools

JiraConfluence
jira_search - Search with JQLconfluence_search - Search with CQL
jira_get_issue - Get issue detailsconfluence_get_page - Get page content
jira_create_issue - Create issuesconfluence_create_page - Create pages
jira_update_issue - Update issuesconfluence_update_page - Update pages
jira_transition_issue - Change statusconfluence_add_comment - Add comments

98 tools total — See Tools Reference for the complete list.

Security

Never share API tokens. Keep .env files secure. See SECURITY.md.

Contributing

See CONTRIBUTING.md for development setup.

License

MIT - See LICENSE. Not an official Atlassian product.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.