{"id":32629837,"url":"https://github.com/varunkumar/atlassian-mcp","last_synced_at":"2025-10-30T22:46:50.344Z","repository":{"id":299733526,"uuid":"1000315187","full_name":"varunkumar/atlassian-mcp","owner":"varunkumar","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-18T02:10:29.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-18T03:24:53.767Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/varunkumar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2025-06-11T15:31:21.000Z","updated_at":"2025-06-18T02:10:32.000Z","dependencies_parsed_at":"2025-06-18T03:35:04.864Z","dependency_job_id":null,"html_url":"https://github.com/varunkumar/atlassian-mcp","commit_stats":null,"previous_names":["varunkumar/atlassian-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/varunkumar/atlassian-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varunkumar%2Fatlassian-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varunkumar%2Fatlassian-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varunkumar%2Fatlassian-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varunkumar%2Fatlassian-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/varunkumar","download_url":"https://codeload.github.com/varunkumar/atlassian-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/varunkumar%2Fatlassian-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281896636,"owners_count":26580138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"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":"2025-10-30T22:46:39.167Z","updated_at":"2025-10-30T22:46:50.339Z","avatar_url":"https://github.com/varunkumar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Atlassian MCP Server\n\nA read-only Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira).\n\n## Installation\n\n```bash\npip install -e .\n```\n\n## Configuration\n\nSet your Atlassian credentials as environment variables:\n\n```bash\nexport ATLASSIAN_DOMAIN=your-company.atlassian.net\nexport ATLASSIAN_EMAIL=your-email@company.com\n\n# Separate tokens for each service (recommended)\nexport ATLASSIAN_CONFLUENCE_TOKEN=your-confluence-token\nexport ATLASSIAN_JIRA_TOKEN=your-jira-token\n\n# OR for backward compatibility, single token (if it has access to both)\nexport ATLASSIAN_API_TOKEN=your-api-token\n```\n\n### Creating API Tokens\n\n1. Go to: https://id.atlassian.com/manage-profile/security/api-tokens\n2. Click \"Create API token\"\n\n**For Confluence:**\n\n- When creating a Confluence token, select these scopes:\n  - `read:content:confluence` - View pages, blog posts, comments, attachments\n  - `read:content-details:confluence` - View content metadata and properties\n\n**For Jira:**\n\n- When creating a Jira token, you'll see different scope options. Look for:\n  - Scopes that allow **reading issues** and **projects**\n  - **Search** capabilities for JQL queries\n  - Basic **browse** permissions\n\n\u003e **Note:** The exact scope names may vary in the Atlassian interface. Choose the minimal read-only scopes that allow viewing issues, projects, and searching. If you're unsure, you can start with broader read permissions and restrict them later.\n\n## Usage\n\nStart the MCP server:\n\n```bash\natlassian-mcp\n```\n\n## Available Tools\n\n### Confluence\n\n- **confluence_get_page** - Get a page by ID\n- **confluence_get_page_by_url** - Get a page by URL\n- **confluence_search_pages** - Search for pages\n- **confluence_list_spaces** - List all spaces\n\n### Jira\n\n- **jira_get_issue** - Get an issue by key (e.g., PROJ-123)\n- **jira_get_issue_by_url** - Get an issue by URL\n- **jira_search_issues** - Search issues using JQL\n- **jira_list_projects** - List all projects\n\n## Supported URLs\n\n### Confluence Pages\n\n- `https://domain.atlassian.net/wiki/spaces/SPACE/pages/123456/Page+Title`\n- `https://domain.atlassian.net/wiki/display/SPACE/Page+Title?pageId=123456`\n- `https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456`\n\n### Jira Issues\n\n- `https://domain.atlassian.net/browse/PROJ-123`\n- `https://domain.atlassian.net/jira/software/projects/PROJ/boards/1?selectedIssue=PROJ-123`\n\n## MCP Client Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"atlassian\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"atlassian_mcp.server\"],\n      \"cwd\": \"/path/to/your/atlassian_mcp\",\n      \"env\": {\n        \"ATLASSIAN_DOMAIN\": \"your-company.atlassian.net\",\n        \"ATLASSIAN_EMAIL\": \"your-email@company.com\",\n        \"ATLASSIAN_CONFLUENCE_TOKEN\": \"your-confluence-token\",\n        \"ATLASSIAN_JIRA_TOKEN\": \"your-jira-token\"\n      }\n    }\n  }\n}\n```\n\n### API Endpoints Used\n\nThis server uses the following Atlassian REST API endpoints:\n\n**Confluence REST API:**\n\n- `GET /wiki/rest/api/content/{id}` - Get page content\n- `GET /wiki/rest/api/content/search` - Search pages using CQL\n- `GET /wiki/rest/api/space` - List spaces\n\n**Jira REST API v3:**\n\n- `GET /rest/api/3/issue/{issueIdOrKey}` - Get issue details\n- `GET /rest/api/3/search` - Search issues using JQL\n- `GET /rest/api/3/project` - List projects\n\nAll endpoints are read-only and require basic authentication with your email and API token.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvarunkumar%2Fatlassian-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvarunkumar%2Fatlassian-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvarunkumar%2Fatlassian-mcp/lists"}