alyiox avatar

Atlassian Attachments

alyiox/mcp-atlassian-attachments

This server downloads Jira and Confluence Cloud attachment files to disk using attachment IDs. It's designed to complement the official Atlassian MCP server, which handles search and issue management but doesn't support pulling down actual attachment files. You authenticate with an API token (scoped or classic), then call download_jira_attachment with an ID and output directory. It handles filename sanitization, optional overwrites, and returns a JSON response with file metadata and local path. Requires Python 3.13+ and at least the read:jira:work scope. Confluence attachment support is on the roadmap but not yet implemented.

tools
4
auth
Secret needed
transport
STDIO
env vars
3
last updated
Aug 24, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

download_jira_attachmentDownload a Jira attachment by ID.

Download a Jira attachment by ID.

No parameter schema in public metadata yet.

upload_jira_attachmentUpload a local file as an attachment on a Jira issue.

Upload a local file as an attachment on a Jira issue.

No parameter schema in public metadata yet.

get_jira_attachment_referenceResolve an existing attachment into an ADF media node.

Resolve an existing attachment into an ADF media node.

No parameter schema in public metadata yet.

delete_jira_attachmentPermanently delete an attachment by ID.

Permanently delete an attachment by ID.

No parameter schema in public metadata yet.

Sponsors

Configuration

ATLASSIAN_SITE_URL

Atlassian Cloud site URL, for example https://yourorg.atlassian.net. Must be HTTPS. Can also be set in ~/.config/mcp-atlassian-attachments/config.json.

ATLASSIAN_EMAIL

Email address used for Atlassian Cloud Basic auth. Can also be set in ~/.config/mcp-atlassian-attachments/config.json.

ATLASSIAN_API_TOKENsecret

Atlassian Cloud API token. Used as the password in Basic auth. Can also be set in ~/.config/mcp-atlassian-attachments/config.json.

Readme

MCP Jira Attachments

CI PyPI Python 3.13+ License: MIT

A Model Context Protocol (MCP) server for downloading Jira Cloud attachments by attachment ID to local disk, and uploading local files as attachments to a Jira issue.

Supplement to the official Atlassian MCP server. The official Atlassian MCP server covers search, issue management, and content operations but does not move attachment files between Jira and local disk. This server fills that gap.


View the full README on GitHub

Details

Repository
github.com/alyiox/mcp-atlassian-attachments
Category
Developer Tools
Package
mcp-atlassian-attachments
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from alyiox

Related Developer Tools MCP servers

View all
1b1ff avatarAtlassian Dc Mcp Confluenceb1ff/atlassian-dc-mcpMCP server for Atlassian Confluence Data Center - access and manage content108stars
2rog0x avatarGitrog0x/mcp-git-toolsGit log, diff, blame, branch stats for AI agents0stars
3dave-london avatarGithubdave-london/pareMCP server for GitHub operations (PRs, issues, actions) with structured, token-efficient output128stars
4aniongithub avatardevcontainer-mcpaniongithub/devcontainer-mcpManage dev container environments via MCP (Docker, DevPod, Codespaces).28stars
5tadas-github avatarA2asearch Mcptadas-github/a2asearch-mcpSearch 10,000+ AI agents, MCP servers, and CLI tools via A2ASearch from any MCP client.17stars
6aybelatchane avatarTerminal MCP Serveraybelatchane/mcp-server-terminalMCP server for AI agents to interact with terminal applications. Think Playwright for terminals.15stars