{"_id":"@amgisllc/atlassian-mcp","_rev":"2-e7664e9836be1cd786cfc7d6702334f6","name":"@amgisllc/atlassian-mcp","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@amgisllc/atlassian-mcp","version":"1.0.0","keywords":["mcp","jira","confluence","atlassian","claude","model-context-protocol"],"author":{"name":"AMGIS LLC"},"license":"MIT","_id":"@amgisllc/atlassian-mcp@1.0.0","maintainers":[{"name":"amgis","email":"jairus.martin@amgis.us"}],"homepage":"https://github.com/amgisllc/atlassian-mcp#readme","bugs":{"url":"https://github.com/amgisllc/atlassian-mcp/issues"},"bin":{"atlassian-mcp":"dist/index.js"},"dist":{"shasum":"af3785a23446e6b0c3b29a5f78c8d07a6191abe9","tarball":"https://registry.npmjs.org/@amgisllc/atlassian-mcp/-/atlassian-mcp-1.0.0.tgz","fileCount":15,"integrity":"sha512-qVFHNXbt1kit8aS7tQ7FKxh412frtjaBc2tZs7Ik8CVVwiPFkZBtWcfUe0EmKUyGirQUFOSuGmiYbYPQg/MoLQ==","signatures":[{"sig":"MEUCIFzhH34WisjHsHIxhPyGmZmFZBzolZmhOtUD1MpTbbf1AiEAwvKyQ8uB5eCkQQxwbNu+M+OKJj1dNMfL4HcH8YOvMWI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":97557},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"918dc9aa6da8b6ca9d204a0ec48b01eec75a372b","scripts":{"dev":"tsx src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","postinstall":"echo 'Thank you for installing @amgisllc/atlassian-mcp! See README for setup instructions.'","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"amgis","email":"jairus.martin@amgis.us"},"repository":{"url":"git+https://github.com/amgisllc/atlassian-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for managing Jira issues and Confluence pages","directories":{},"_nodeVersion":"18.20.8","dependencies":{"axios":"^1.12.2","dotenv":"^17.2.3","@modelcontextprotocol/sdk":"^1.20.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","typescript":"^5.9.3","@types/node":"^24.9.0"},"_npmOperationalInternal":{"tmp":"tmp/atlassian-mcp_1.0.0_1760984627188_0.30470340140217433","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@amgisllc/atlassian-mcp","version":"1.1.0","description":"MCP server for managing Jira issues and Confluence pages","main":"dist/index.js","type":"module","bin":{"atlassian-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","clean":"rm -rf dist","prepublishOnly":"npm run clean && npm run build","postinstall":"echo 'Thank you for installing @amgisllc/atlassian-mcp! See README for setup instructions.'"},"keywords":["mcp","jira","confluence","atlassian","claude","model-context-protocol"],"author":{"name":"AMGIS LLC"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/amgisllc/atlassian-mcp.git"},"bugs":{"url":"https://github.com/amgisllc/atlassian-mcp/issues"},"homepage":"https://github.com/amgisllc/atlassian-mcp#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.20.1","axios":"^1.12.2","dotenv":"^17.2.3"},"devDependencies":{"@types/node":"^24.9.0","tsx":"^4.20.6","typescript":"^5.9.3"},"_id":"@amgisllc/atlassian-mcp@1.1.0","gitHead":"c259d63bbf55e7a99995866859de4c59588f64c7","types":"./dist/index.d.ts","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-FJQW3ccGyOlhMDmZApGw5hHgt9CKH3iLREcBec1h6eXxqfB5TBK8pNfjzGyIFXz3Anot0En0p1denNE3Kl8Khw==","shasum":"8965d37d6faf6bf95fa15294ff3c2797db7584ce","tarball":"https://registry.npmjs.org/@amgisllc/atlassian-mcp/-/atlassian-mcp-1.1.0.tgz","fileCount":27,"unpackedSize":153852,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDQ2iUOLga0lu4azb7E6sDNQ46VKQCkjfjEtSVGiqvZ1AIhAMz9I69oYoX9olwMwPaBO3dVdEReeZutuNGhE+6E7i4G"}]},"_npmUser":{"name":"amgis","email":"jairus.martin@amgis.us"},"directories":{},"maintainers":[{"name":"amgis","email":"jairus.martin@amgis.us"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/atlassian-mcp_1.1.0_1760985947133_0.0665837247027512"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-20T18:23:47.128Z","modified":"2025-10-20T18:45:47.623Z","1.0.0":"2025-10-20T18:23:47.406Z","1.1.0":"2025-10-20T18:45:47.363Z"},"bugs":{"url":"https://github.com/amgisllc/atlassian-mcp/issues"},"author":{"name":"AMGIS LLC"},"license":"MIT","homepage":"https://github.com/amgisllc/atlassian-mcp#readme","keywords":["mcp","jira","confluence","atlassian","claude","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/amgisllc/atlassian-mcp.git"},"description":"MCP server for managing Jira issues and Confluence pages","maintainers":[{"name":"amgis","email":"jairus.martin@amgis.us"}],"readme":"# @amgisllc/atlassian-mcp\n\nA Model Context Protocol (MCP) server for interacting with Jira and Confluence APIs. This server provides tools to manage Jira issues and Confluence pages directly from Claude or other MCP-compatible clients.\n\n[![npm version](https://badge.fury.io/js/@amgisllc%2Fatlassian-mcp.svg)](https://www.npmjs.com/package/@amgisllc/atlassian-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Features\n\n### Jira Operations\n- Search issues with JQL or natural language queries\n- Create, read, update, and delete issues (including bulk operations)\n- Add comments and manage transitions\n- Sprint management (boards, sprints, move issues)\n- Time tracking (worklog, estimates)\n- Watchers management\n- Issue linking and dependencies\n- Advanced filtering and saved searches\n- Assign issues to users\n- Manage projects, components, and labels\n\n### Confluence Operations\n- Search pages with CQL or filters\n- Create, read, update, and delete pages\n- Manage spaces\n- Add comments to pages\n- Copy and move pages\n- Get page children and hierarchy\n- Support for both storage and wiki markup formats\n\n## Installation\n\n### Option 1: Install from npm (Recommended)\n\n```bash\nnpm install -g @amgisllc/atlassian-mcp\n```\n\nOr install locally in a project:\n\n```bash\nnpm install @amgisllc/atlassian-mcp\n```\n\n### Option 2: Install from source\n\n1. Clone this repository\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Build the project:\n```bash\nnpm run build\n```\n\n## Configuration\n\nCreate a `.env` file in the project root with your Atlassian credentials:\n\n```env\n# Jira Configuration\nJIRA_DOMAIN=your-domain\nJIRA_EMAIL=your-email@example.com\nJIRA_API_TOKEN=your-jira-api-token\n\n# Confluence Configuration (optional, can use same as Jira)\nCONFLUENCE_DOMAIN=your-domain\nCONFLUENCE_EMAIL=your-email@example.com\nCONFLUENCE_API_TOKEN=your-confluence-api-token\n```\n\n### Getting API Tokens\n\n1. Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click \"Create API token\"\n3. Give it a descriptive name\n4. Copy the token and use it in your `.env` file\n\n### Domain Configuration\n\nThe domain is the first part of your Atlassian URL:\n- If your Jira URL is `https://mycompany.atlassian.net`, then `JIRA_DOMAIN=mycompany`\n- Same applies for Confluence\n\n## Usage with Claude Desktop\n\nAdd the following to your Claude Desktop configuration file:\n\n### If installed globally via npm:\n\n#### macOS/Linux\nEdit `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"atlassian\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@amgisllc/atlassian-mcp\"],\n      \"env\": {\n        \"JIRA_DOMAIN\": \"your-domain\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n#### Windows\nEdit `%APPDATA%\\Claude\\claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"atlassian\": {\n      \"command\": \"npx.cmd\",\n      \"args\": [\"-y\", \"@amgisllc/atlassian-mcp\"],\n      \"env\": {\n        \"JIRA_DOMAIN\": \"your-domain\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### If installed from source:\n\nUse the full path to your built index.js file:\n\n```json\n{\n  \"mcpServers\": {\n    \"atlassian\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/atlassian-mcp/dist/index.js\"],\n      \"env\": {\n        \"JIRA_DOMAIN\": \"your-domain\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n## New in Version 1.1.0\n\n### Natural Language Queries\nYou can now use natural language to search for issues:\n- \"my open bugs in project TSA\"\n- \"high priority tasks from last week\"\n- \"unassigned issues created today\"\n\n### Bulk Operations\nPerform actions on multiple issues at once:\n- Bulk update fields\n- Bulk transitions\n- Bulk delete\n\n### Sprint Management\nFull agile board support:\n- View boards and sprints\n- Move issues between sprints\n- Get sprint reports\n\n### Enhanced Features\n- **Time Tracking**: Log work, update estimates\n- **Watchers**: Add/remove watchers on issues\n- **Issue Links**: Create dependencies between issues\n- **Smart Caching**: Improved performance with intelligent caching\n- **Validation**: Input validation and better error messages\n\n## Available Tools\n\n### Jira Tools\n\n#### jira_search_issues\nSearch for Jira issues using JQL or filters.\n- Parameters:\n  - `jql` (optional): JQL query string\n  - `projectKey` (optional): Filter by project\n  - `status` (optional): Filter by status\n  - `assignee` (optional): Filter by assignee\n  - `reporter` (optional): Filter by reporter\n  - `maxResults` (optional): Maximum results (default: 50)\n\n#### jira_get_issue\nGet details of a specific Jira issue.\n- Parameters:\n  - `issueKey` (required): Issue key (e.g., PROJ-123)\n\n#### jira_create_issue\nCreate a new Jira issue.\n- Parameters:\n  - `projectKey` (required): Project key\n  - `summary` (required): Issue summary\n  - `issueTypeName` (required): Issue type (Bug, Task, Story, etc.)\n  - `description` (optional): Issue description\n  - `priority` (optional): Priority level\n  - `assigneeAccountId` (optional): Assignee's account ID\n  - `labels` (optional): Array of labels\n  - `components` (optional): Array of components\n  - `customFields` (optional): Custom field values\n\n#### jira_update_issue\nUpdate an existing Jira issue.\n- Parameters:\n  - `issueKey` (required): Issue key\n  - `summary` (optional): New summary\n  - `description` (optional): New description\n  - `priority` (optional): New priority\n  - `assigneeAccountId` (optional): New assignee\n  - `labels` (optional): New labels\n  - `components` (optional): New components\n  - `customFields` (optional): Custom field updates\n\n#### jira_delete_issue\nDelete a Jira issue.\n- Parameters:\n  - `issueKey` (required): Issue key to delete\n\n#### jira_add_comment\nAdd a comment to a Jira issue.\n- Parameters:\n  - `issueKey` (required): Issue key\n  - `comment` (required): Comment text\n\n#### jira_transition_issue\nTransition an issue to a different status.\n- Parameters:\n  - `issueKey` (required): Issue key\n  - `transitionName` or `transitionId`: Transition to apply\n  - `comment` (optional): Transition comment\n  - `resolution` (optional): Resolution for closed issues\n\n#### jira_get_projects\nGet list of all accessible Jira projects.\n\n#### jira_get_issue_types\nGet available issue types for a project.\n- Parameters:\n  - `projectKey` (required): Project key\n\n#### jira_assign_issue\nAssign an issue to a user.\n- Parameters:\n  - `issueKey` (required): Issue key\n  - `accountId` (required): User's account ID\n\n#### jira_get_comments\nGet all comments for an issue.\n- Parameters:\n  - `issueKey` (required): Issue key\n\n#### jira_search_users\nSearch for Jira users.\n- Parameters:\n  - `query` (optional): Search query\n\n### Confluence Tools\n\n#### confluence_search_content\nSearch for Confluence pages.\n- Parameters:\n  - `cql` (optional): CQL query string\n  - `spaceKey` (optional): Filter by space\n  - `title` (optional): Filter by title\n  - `text` (optional): Search in content\n  - `limit` (optional): Maximum results (default: 25)\n\n#### confluence_get_page\nGet details of a specific page.\n- Parameters:\n  - `pageId` (required): Page ID\n\n#### confluence_create_page\nCreate a new Confluence page.\n- Parameters:\n  - `spaceKey` (required): Space key\n  - `title` (required): Page title\n  - `content` (required): Page content\n  - `parentId` (optional): Parent page ID\n  - `format` (optional): Content format ('storage' or 'wiki')\n\n#### confluence_update_page\nUpdate an existing page.\n- Parameters:\n  - `pageId` (required): Page ID\n  - `title` (optional): New title\n  - `content` (optional): New content\n  - `versionMessage` (optional): Version message\n  - `format` (optional): Content format\n\n#### confluence_delete_page\nDelete a Confluence page.\n- Parameters:\n  - `pageId` (required): Page ID\n\n#### confluence_get_spaces\nGet list of all accessible spaces.\n- Parameters:\n  - `limit` (optional): Maximum results\n\n#### confluence_get_space\nGet details of a specific space.\n- Parameters:\n  - `spaceKey` (required): Space key\n\n#### confluence_create_space\nCreate a new Confluence space.\n- Parameters:\n  - `key` (required): Space key\n  - `name` (required): Space name\n  - `description` (optional): Space description\n\n#### confluence_get_page_children\nGet child pages of a page.\n- Parameters:\n  - `pageId` (required): Parent page ID\n  - `limit` (optional): Maximum results\n\n#### confluence_add_page_comment\nAdd a comment to a page.\n- Parameters:\n  - `pageId` (required): Page ID\n  - `comment` (required): Comment text\n\n#### confluence_copy_page\nCopy a page to a new location.\n- Parameters:\n  - `pageId` (required): Page to copy\n  - `newTitle` (required): Title for the copy\n  - `targetSpaceKey` (optional): Target space\n  - `targetParentId` (optional): Target parent page\n\n#### confluence_move_page\nMove a page to a different location.\n- Parameters:\n  - `pageId` (required): Page to move\n  - `targetSpaceKey` (optional): Target space\n  - `targetParentId` (optional): Target parent page\n\n## Development\n\n### Run in development mode:\n```bash\nnpm run dev\n```\n\n### Build the project:\n```bash\nnpm run build\n```\n\n### Clean build artifacts:\n```bash\nnpm run clean\n```\n\n## Example Usage in Claude\n\nOnce configured, you can use commands like:\n\n```\n\"Search for all open bugs in project ABC\"\n\"Create a new task in project XYZ with title 'Update documentation'\"\n\"Add a comment to issue ABC-123 saying 'This has been resolved'\"\n\"Create a new Confluence page in space DOCS with title 'API Guide'\"\n\"Search for Confluence pages containing 'deployment'\"\n```\n\n## Troubleshooting\n\n### Authentication Issues\n- Ensure your API token is valid and not expired\n- Verify the domain name is correct (without `.atlassian.net`)\n- Check that your account has necessary permissions\n\n### Connection Issues\n- Verify your internet connection\n- Check if Atlassian services are operational\n- Ensure firewall/proxy settings allow HTTPS connections\n\n### Permission Issues\n- Verify your account has access to the projects/spaces\n- Check project/space permissions in Atlassian admin settings\n- Some operations may require admin privileges\n\n## Security Notes\n\n- Never commit your `.env` file to version control\n- Keep your API tokens secure and rotate them regularly\n- Use environment variables or secure credential storage in production\n- Consider using separate API tokens for different environments\n\n## License\n\nMIT\n\n## Support\n\nFor issues or questions:\n1. Check the Atlassian API documentation\n2. Review the error messages returned by the tools\n3. Ensure your API tokens have the necessary scopes\n4. Check Atlassian service status","readmeFilename":"README.md"}