freshcrate
Home > MCP Servers > mcp-atlassian

mcp-atlassian

MCP server for Atlassian tools (Confluence, Jira)

Description

MCP server for Atlassian tools (Confluence, Jira)

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.

mcp-atlassian-jira-demo.mp4
Confluence Demo
confluence-1k.mp4

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": "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"
      }
    }
  }
}

Server/Data Center users: Use JIRA_PERSONAL_TOKEN instead of JIRA_USERNAME + JIRA_API_TOKEN. See Authentication for 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:

Topic Description
Installation uvx, Docker, pip, from source
Authentication API tokens, PAT, OAuth 2.0
Configuration IDE setup, environment variables
HTTP Transport SSE, streamable-http, multi-user
Tools Reference All Jira & Confluence tools
Troubleshooting Common issues & debugging

Compatibility

Product Deployment Support
Confluence Cloud Fully supported
Confluence Server/Data Center Supported (v6.0+)
Jira Cloud Fully supported
Jira Server/Data Center Supported (v8.14+)

Key Tools

Jira Confluence
jira_search - Search with JQL confluence_search - Search with CQL
jira_get_issue - Get issue details confluence_get_page - Get page content
jira_create_issue - Create issues confluence_create_page - Create pages
jira_update_issue - Update issues confluence_update_page - Update pages
jira_transition_issue - Change status confluence_add_comment - Add comments

72 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.

Release History

VersionChangesUrgencyDate
v0.21.1This release fixes a critical startup crash caused by an upstream dependency break and ships a few community-contributed features that landed on main since v0.21.0. ## 🐛 Fixed ### Server / Transport - **Startup crash on fresh `uvx` installs**: `fakeredis 2.35.0` renamed `FakeConnection` without a backward-compatible alias, breaking `pydocket`'s runtime import and making FastMCP's lifespan fail with `ImportError: cannot import name 'FakeConnection' from 'fakeredis.aioredis'`. Pinned `fakeredisHigh4/10/2026

Dependencies & License Audit

Loading dependencies...

Similar Packages

hybrid-orchestrator🤖 Implement hybrid human-AI orchestration patterns in Python to coordinate agents, manage sessions, and enable smooth AI-human handoffs.master@2026-04-21
aiA productive AI coworker that learns, self-improves, and ships work.main@2026-04-21
comfy-pilot🤖 Create and modify workflows effortlessly with ComfyUI's AI assistant, enabling natural conversations with agents like Claude and Gemini.main@2026-04-21
claude-api-cost-optimization💰 Optimize your Claude API usage to save 50-90% on costs with batching techniques and efficient request management.main@2026-04-21
spoon-awesome-skill🚀 Explore high-quality skills for SpoonOS, Web3, AI productivity, and enterprise tooling with 57+ curated Python scripts across multiple challenge tracks.master@2026-04-21