{"id":50956305,"url":"https://github.com/alyiox/mcp-atlassian-attachments","last_synced_at":"2026-06-18T07:02:57.443Z","repository":{"id":355973818,"uuid":"1225298359","full_name":"alyiox/mcp-atlassian-attachments","owner":"alyiox","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-06T03:24:57.000Z","size":57,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-06T05:21:20.970Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alyiox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-30T06:28:06.000Z","updated_at":"2026-05-06T03:25:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alyiox/mcp-atlassian-attachments","commit_stats":null,"previous_names":["alyiox/mcp-atlassian-attachments"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/alyiox/mcp-atlassian-attachments","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alyiox%2Fmcp-atlassian-attachments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alyiox%2Fmcp-atlassian-attachments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alyiox%2Fmcp-atlassian-attachments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alyiox%2Fmcp-atlassian-attachments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alyiox","download_url":"https://codeload.github.com/alyiox/mcp-atlassian-attachments/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alyiox%2Fmcp-atlassian-attachments/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34479555,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-18T07:02:56.687Z","updated_at":"2026-06-18T07:02:57.434Z","avatar_url":"https://github.com/alyiox.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCP Atlassian Attachments\n\n\u003c!-- mcp-name: io.github.alyiox/mcp-atlassian-attachments --\u003e\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for downloading Jira Cloud attachments by attachment ID to local disk.\n\n\u003e **Supplement to the official Atlassian MCP server.**\n\u003e The [official Atlassian MCP server](https://mcp.atlassian.com/v1/mcp) covers search, issue management, and content operations but does not support downloading attachment files to disk. This server fills that gap.\n\n**Requirements:** Python 3.13+, an Atlassian Cloud account, and an API token with at least the `read:jira-work` scope.\n\n## Authentication\n\nScoped tokens are recommended to limit access to exactly the permissions needed.\n\n\u003e **Note:** The granular `read:attachment:jira` scope is not sufficient — Jira's attachment metadata endpoint (`/rest/api/3/attachment/{id}`) requires `read:jira-work` to resolve issue-level permissions. A classic (unscoped) API token also works.\n\n### Create an API token\n\n1. Go to [id.atlassian.com/manage-profile/security/api-tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click **Create API token**\n3. Choose **\"Create API token with scopes\"** and select the `read:jira-work` scope, **or** choose **\"Classic API token\"** for full access\n4. Copy the generated token\n\n## Quick start\n\nThe fastest way to try the server is with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector). Set the three required environment variables and run:\n\n**From the published package** (no clone needed):\n\n```bash\nATLASSIAN_SITE_URL=https://yourorg.atlassian.net \\\nATLASSIAN_EMAIL=your.email@example.com \\\nATLASSIAN_API_TOKEN=your-api-token \\\nnpx -y @modelcontextprotocol/inspector uvx mcp-atlassian-attachments\n```\n\n**From a local clone:**\n\n```bash\nATLASSIAN_SITE_URL=https://yourorg.atlassian.net \\\nATLASSIAN_EMAIL=your.email@example.com \\\nATLASSIAN_API_TOKEN=your-api-token \\\nnpx -y @modelcontextprotocol/inspector uv run mcp-atlassian-attachments\n```\n\n## Configuration\n\nSet environment variables or create a config file. Environment variables take priority.\n\n**Environment variables:**\n\n```bash\nexport ATLASSIAN_SITE_URL=\"https://yourorg.atlassian.net\"\nexport ATLASSIAN_EMAIL=\"your.email@example.com\"\nexport ATLASSIAN_API_TOKEN=\"your-api-token\"\n```\n\n**Config file** (`~/.config/mcp-atlassian-attachments/config.json`):\n\n```json\n{\n  \"site_url\": \"https://yourorg.atlassian.net\",\n  \"email\": \"your.email@example.com\",\n  \"api_token\": \"your-api-token\"\n}\n```\n\n## Tools\n\n| Tool | Description | Required params |\n|------|-------------|-----------------|\n| **`download_jira_attachment`** | Download a Jira attachment by ID. | `attachment_id`, `output_dir` |\n\n### Common parameters\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `attachment_id` | string | Jira attachment ID |\n| `output_dir` | string | Local directory for the saved file. Created automatically if it does not exist. |\n| `filename` | string (optional) | Override filename. Uses metadata filename when omitted. |\n| `overwrite` | bool (optional) | Replace an existing file. Defaults to `false`. |\n\n### Output\n\nThe tool returns a JSON object:\n\n```json\n{\n  \"product\": \"jira\",\n  \"attachmentId\": \"439535\",\n  \"filename\": \"screenshot.png\",\n  \"mimeType\": \"image/png\",\n  \"size\": 496724,\n  \"path\": \"/your/output/dir/screenshot.png\",\n  \"sourceUrl\": \"https://yourorg.atlassian.net/rest/api/3/attachment/content/439535\"\n}\n```\n\n## MCP host configuration\n\nAdd the following to your MCP host's config file. The JSON is the same for Cursor (`.cursor/mcp.json`), Claude Desktop (`claude_desktop_config.json`), and Claude Code (`.claude.json`).\n\n```json\n{\n  \"mcpServers\": {\n    \"atlassian\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-atlassian-attachments\"],\n      \"env\": {\n        \"ATLASSIAN_SITE_URL\": \"https://yourorg.atlassian.net\",\n        \"ATLASSIAN_EMAIL\": \"your.email@example.com\",\n        \"ATLASSIAN_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n## Security\n\n- `ATLASSIAN_API_TOKEN` is never logged or included in error messages.\n- The computed `Authorization` header is never exposed in tool output or errors.\n- File writes are confined to the provided `output_dir`.\n- Filenames are sanitized to prevent path traversal.\n\n## Tests\n\n```bash\nuv run pytest tests/ -v\n```\n\n## Roadmap\n\n- **`download_confluence_attachment_tool`** — Confluence Cloud uses a different API (`/wiki/api/v2/`) and a different identifier model. Planned for a future release.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falyiox%2Fmcp-atlassian-attachments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falyiox%2Fmcp-atlassian-attachments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falyiox%2Fmcp-atlassian-attachments/lists"}