Atlassian (Jira + Confluence)

• v0.21.1 Latest Apr 10, 2026

  This 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 `fakeredis>=2.32.1,<2.35.0` as a downstream constraint until upstream ships a fix. Users no longer need the `--with fakeredis==2.34.1` workaround ([#1250](https://github.com/sooperset/mcp-atlassian/pull/1250), fixes [#1248](https://github.com/sooperset/mcp-atlassian/issues/1248)).
  
  ### Confluence
  - **`include_content` test coverage and descriptions**: Follow-up hardening for the new `include_content` option ([#1099](https://github.com/sooperset/mcp-atlassian/pull/1099)).
  
  ## ✨ Features
  
  ### Confluence
  - **`include_content` on create/update**: `confluence_create_page` and `confluence_update_page` now accept an `include_content` flag so callers can skip echoing full page bodies back in responses ([#1098](https://github.com/sooperset/mcp-atlassian/pull/1098)).
  - **`confluence_get_space_page_tree`**: New tool for discovering a space's page hierarchy in a single call ([#1090](https://github.com/sooperset/mcp-atlassian/pull/1090)).
  
  ### Deployment
  - **Helm: OAuth proxy + client storage configuration**: Helm chart now exposes FastMCP auth's OAuth proxy and client storage settings so operators can configure them declaratively ([#1084](https://github.com/sooperset/mcp-atlassian/pull/1084)).
  
  ## Contributors
  
  Thanks to @kimoto, @Poggen, and @Troubladore!
  
  **Full Changelog**: https://github.com/sooperset/mcp-atlassian/compare/v0.21.0...v0.21.1

  View on GitHub ↗
• v0.21.0 Mar 2, 2026

  This release adds 4 new tools (sprint management, page moves, page diffs, comment replies), OAuth proxy support, markdown table rendering, and multiple content processing fixes.
  
  ## ✨ Features
  
  ### Jira
  - **Sprint Management**: Move issues between sprints with the new `jira_add_issues_to_sprint` tool ([#1078](https://github.com/sooperset/mcp-atlassian/pull/1078))
  - **Cloud Search Pagination**: `jira_search` now returns `next_page_token` for cursor-based pagination on Cloud ([#1079](https://github.com/sooperset/mcp-atlassian/pull/1079))
  - **Field Options Filtering**: `jira_get_field_options` supports `contains`, `return_limit`, and `values_only` params for targeted lookups ([#1074](https://github.com/sooperset/mcp-atlassian/pull/1074))
  - **Markdown Tables**: Markdown tables in descriptions and comments are now converted to native ADF table nodes on Cloud ([#1089](https://github.com/sooperset/mcp-atlassian/pull/1089))
  
  ### Confluence
  - **Move Pages**: Relocate pages between parents or spaces with the new `confluence_move_page` tool ([#1080](https://github.com/sooperset/mcp-atlassian/pull/1080))
  - **Page Version Diff**: Compare two page versions with the new `confluence_get_page_diff` tool ([#1083](https://github.com/sooperset/mcp-atlassian/pull/1083))
  - **Comment Replies**: Reply to existing comments with the new `confluence_reply_to_comment` tool ([#1070](https://github.com/sooperset/mcp-atlassian/pull/1070))
  - **Page Width Layout**: Library-level support for controlling page width (`default` / `full-width`) on Cloud. Available via the Confluence fetcher API; MCP tool integration planned for a future release ([#1091](https://github.com/sooperset/mcp-atlassian/pull/1091))
  - **Server/DC User Search**: `confluence_search_user` now supports Server/DC via group member fallback ([#1081](https://github.com/sooperset/mcp-atlassian/pull/1081))
  
  ### Authentication
  - **OAuth Proxy**: Opt-in OAuth 2.0 proxy with Dynamic Client Registration (DCR), PKCE, consent flow, and grant type hardening ([#1054](https://github.com/sooperset/mcp-atlassian/pull/1054))
  - **Header Auth Bypass**: New `IGNORE_HEADER_AUTH` env var to ignore proxy-injected Authorization headers and use server-configured credentials ([#1073](https://github.com/sooperset/mcp-atlassian/pull/1073))
  
  ## 🐛 Fixed
  
  ### Jira
  - **Code Block Corruption**: `{code}` and `{noformat}` blocks in Server/DC wiki markup are now protected from markup conversion corruption ([#1059](https://github.com/sooperset/mcp-atlassian/pull/1059))
  - **Custom Field Preservation**: Complex custom field values (nested objects, arrays) are no longer silently converted to strings ([#1058](https://github.com/sooperset/mcp-atlassian/pull/1058))
  - **Panel Block Handling**: `{panel}` blocks and bare URLs in wiki markup are now correctly converted to markdown ([#1055](https://github.com/sooperset/mcp-atlassian/pull/1055))
  - **Field Name Matching**: `fixVersions`, `issuetype`, and other API field names are now correctly recognized in `should_include_field` checks, fixing field exclusion when users request specific fields ([#1076](https://github.com/sooperset/mcp-atlassian/pull/1076))
  
  ### Preprocessing
  - **Code Span Truncation**: Inline code spans (`<code>`) are no longer broken by HTML content truncation ([#1094](https://github.com/sooperset/mcp-atlassian/pull/1094))
  
  ## 🔒 Security
  - **URL Validation Bypass**: Prevented SSRF allowlist bypass where `evil-atlassian.net` could match the `atlassian.net` domain check — now uses strict `.{domain}` suffix matching ([#1087](https://github.com/sooperset/mcp-atlassian/pull/1087))
  
  ## Contributors
  
  Thanks to @Poggen, @Troubladore, @djb2c, @Lama9, @iiiokojiadbi, @Arbuzov, @solganik, @johnny, @pibylick, @nulvox, @yliu, and @reneleonhardt!
  
  **Full Changelog**: https://github.com/sooperset/mcp-atlassian/compare/v0.20.1...v0.21.0

  View on GitHub ↗
• v0.20.1 Feb 27, 2026

  This release fixes error handling for the ServiceDesk comment API on non-JSM projects.
  
  ## 🐛 Fixed
  
  ### Jira
  - **ServiceDesk 403 handling**: Non-JSM projects return 403 Forbidden (not 404) from the ServiceDesk API when using the `public` parameter for internal/external comments. The error message now clearly indicates the issue is not a JSM service desk project or the user lacks permission ([#1051](https://github.com/sooperset/mcp-atlassian/pull/1051))
  
  **Full Changelog**: https://github.com/sooperset/mcp-atlassian/compare/v0.20.0...v0.20.1

  View on GitHub ↗
• v0.20.0 Feb 27, 2026

  This release adds JSM internal comment support, a Kubernetes Helm chart, and fixes for worklog ADF handling and tool parameter naming.
  
  ## ✨ Features
  
  ### Jira
  - **JSM Internal Comments**: New `public` parameter on `add_comment` tool for Jira Service Management issues. Set `public=true` for customer-visible comments or `public=false` for internal agent-only comments. Routes through the ServiceDesk API with plain text body ([#1049](https://github.com/sooperset/mcp-atlassian/pull/1049), fixes [#867](https://github.com/sooperset/mcp-atlassian/issues/867))
  
  ### Deployment
  - **Kubernetes Helm Chart**: Deploy mcp-atlassian on Kubernetes with a full-featured Helm chart supporting all auth modes, transport types (stdio/SSE/streamable-HTTP), HPA, ingress, PVC for OAuth tokens, and RBAC ([#737](https://github.com/sooperset/mcp-atlassian/pull/737), [#1048](https://github.com/sooperset/mcp-atlassian/pull/1048))
  
  ## 🐛 Fixed
  
  ### Jira
  - **Worklog ADF Comments on Cloud**: Worklog comments were silently dropped on Cloud because ADF dicts from `_markdown_to_jira()` were posted to the v2 API which ignores them. Now routes through v3 API when the comment is ADF, matching the existing pattern in comments ([#1047](https://github.com/sooperset/mcp-atlassian/pull/1047), fixes [#1045](https://github.com/sooperset/mcp-atlassian/issues/1045))
  
  ### Server
  - **Tool Parameter Naming**: Aligned MCP tool parameter names with their response field names for consistency — `comment_body` → `body`, `issue_description` → `description`, etc. ([#1044](https://github.com/sooperset/mcp-atlassian/pull/1044))
  - **Descriptive Error Messages**: Tool handlers now return specific error descriptions instead of generic messages ([#1010](https://github.com/sooperset/mcp-atlassian/pull/1010))
  
  ## 📚 Documentation
  - Updated parameter names in documentation to match the tool renames ([#1046](https://github.com/sooperset/mcp-atlassian/pull/1046))
  
  ## Contributors
  
  Thanks to @antweiss, @baumgold, and @hteichmann-strato!
  
  **Full Changelog**: https://github.com/sooperset/mcp-atlassian/compare/v0.19.0...v0.20.0

  View on GitHub ↗
• v0.19.0 Feb 27, 2026

  This release adds toolset-based tool filtering for granular control over which tools are exposed, OS native trust store support for enterprise SSL environments, and Jira issue watcher tools.
  
  ## ✨ Features
  
  ### Server
  - **Toolset-Based Tool Filtering**: New `TOOLSETS` env var groups 68 tools into 21 named toolsets (15 Jira, 6 Confluence) for granular control. Supports `all`, `default`, and comma-separated names. All toolsets enabled by default — in v0.22.0 the default will change to 6 core toolsets only ([#1041](https://github.com/sooperset/mcp-atlassian/pull/1041), [#1043](https://github.com/sooperset/mcp-atlassian/pull/1043))
  
  ### Jira
  - **Issue Watcher Tools**: New `jira_get_issue_watchers`, `jira_add_watcher`, and `jira_remove_watcher` tools for managing issue watchers. Write operations respect `READ_ONLY_MODE` ([#1039](https://github.com/sooperset/mcp-atlassian/pull/1039), fixes [#1032](https://github.com/sooperset/mcp-atlassian/issues/1032))
  
  ### Authentication
  - **OS Native Trust Store**: SSL connections now verify certificates against the OS trust store (Windows Certificate Store, macOS Keychain, Linux system CAs) via `truststore`, enabling enterprise environments with internal CAs to connect without disabling SSL verification. Opt out with `MCP_ATLASSIAN_USE_SYSTEM_TRUSTSTORE=false` ([#976](https://github.com/sooperset/mcp-atlassian/pull/976))
  
  ## 🐛 Fixed
  
  ### Jira
  - **JiraUser Username/Key Fields**: `JiraUser.from_api_response()` was mapping `displayName` to both `display_name` and `name`, discarding the login username needed for Server/DC `[~username]` mentions. Now preserves `username` and `user_key` fields separately ([#1038](https://github.com/sooperset/mcp-atlassian/pull/1038), fixes [#1031](https://github.com/sooperset/mcp-atlassian/issues/1031))
  - **Underscore in Project Keys**: Issue key patterns like `D_DEV-123` were not recognized in both server tools and preprocessing due to missing `_` in regex character classes ([#1030](https://github.com/sooperset/mcp-atlassian/pull/1030), [#1035](https://github.com/sooperset/mcp-atlassian/pull/1035))
  - **Windows Timestamp Overflow**: Jira DC sentinel dates (year 9999) caused `OverflowError`/`OSError` on Windows. `parse_date` now catches these and returns `None` gracefully ([#1037](https://github.com/sooperset/mcp-atlassian/pull/1037), fixes [#1033](https://github.com/sooperset/mcp-atlassian/issues/1033))
  
  ### Authentication
  - **Truststore Env Var Parsing**: Fixed `AttributeError` when `.env` contains a bare key (no `=` sign) — `dotenv_values()` returns `None` which broke `.lower()` at import time ([#1036](https://github.com/sooperset/mcp-atlassian/pull/1036))
  
  ### Server / Transport
  - **Allowlisted Domains Bypass DNS**: Domains in `ALLOWED_DOMAINS` now bypass DNS resolution checks, fixing false rejections for internal hostnames ([#1005](https://github.com/sooperset/mcp-atlassian/pull/1005))
  
  ## 🧪 Testing
  - **Test Reclassification**: Mock-based integration tests moved to unit tests, model tests split to match source structure, Cloud/Server pairs parametrized ([#1015](https://github.com/sooperset/mcp-atlassian/pull/1015), [#1016](https://github.com/sooperset/mcp-atlassian/pull/1016), [#1021](https://github.com/sooperset/mcp-atlassian/pull/1021))
  
  ## 📚 Documentation
  - **Auto-Generated Tool Reference**: Full reference pages for all 68 MCP tools with parameters, examples, and toolset tags ([#1017](https://github.com/sooperset/mcp-atlassian/pull/1017))
  - **New Guides**: JQL/CQL query guides, workflow recipes, SLA metrics, Docker deployment, and expanded troubleshooting ([#1018](https://github.com/sooperset/mcp-atlassian/pull/1018), [#1019](https://github.com/sooperset/mcp-atlassian/pull/1019))
  
  ## Contributors
  
  Thanks to @tsondergaard, @fatherlinux, @alvaroEset, and @bbkmike!
  
  **Full Changelog**: https://github.com/sooperset/mcp-atlassian/compare/v0.18.0...v0.19.0

  View on GitHub ↗

No comments yet. Sign in to start the discussion.

More Productivity servers

• Time

  Time + timezone utilities — current time, conversions, formatting across IANA timezones.

• Google Maps

  Geocoding, directions, place search, and distance-matrix lookups via the Google Maps API.

• Linear

  Browse + create Linear issues, projects, and cycles — full CRUD with filter support.