{"_id":"@orengrinker/jira-mcp-server","_rev":"4-7cbd2fc43aac1f8b23c830fb866d2075","name":"@orengrinker/jira-mcp-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@orengrinker/jira-mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","jira","atlassian","issue-tracking","project-management","ai","claude","automation"],"author":{"name":"Oren Grinker"},"license":"MIT","_id":"@orengrinker/jira-mcp-server@1.0.0","maintainers":[{"name":"orengrinker","email":"orengr4@gmail.com"}],"homepage":"https://github.com/OrenGrinker/jira-mcp-server#readme","bugs":{"url":"https://github.com/OrenGrinker/jira-mcp-server/issues"},"dist":{"shasum":"0f110ebeddd3954c81109a574a0d12e6816a80f8","tarball":"https://registry.npmjs.org/@orengrinker/jira-mcp-server/-/jira-mcp-server-1.0.0.tgz","fileCount":83,"integrity":"sha512-NUzehVtxeDiyxxe/9oqS7eqjJ/r0qJlH1FVA0tHIvS+9MoaPRrZ5YsortOmzgQTbqIn5AlxchCyOCSgNYkBR+A==","signatures":[{"sig":"MEUCIQCSF4N9i/01GKZimG4L5REwuq2AGrXwGmxRiFd+fCgXGQIgWUGfs0wzcmi3x493zRPIx0KnCFpE8EKP0IbzEQySN2o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":273339},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"3ba61ee03622066d440a7a2080caabe9078a3e2e","scripts":{"dev":"tsx src/index.ts","test":"echo \"No tests yet\" && exit 0","build":"npm run clean && tsc && chmod +x dist/index.js","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"orengrinker","actor":{"name":"orengrinker","type":"user","email":"orengr4@gmail.com"},"email":"orengr4@gmail.com"},"repository":{"url":"git+https://github.com/OrenGrinker/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"A comprehensive Model Context Protocol server for Jira integration with issue management, board operations, time tracking, and project management capabilities","directories":{},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","rimraf":"^5.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.0_1750415524102_0.8971196981236289","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@orengrinker/jira-mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","jira","atlassian","issue-tracking","project-management","ai","claude","automation"],"author":{"name":"Oren Grinker"},"license":"MIT","_id":"@orengrinker/jira-mcp-server@1.0.1","maintainers":[{"name":"orengrinker","email":"orengr4@gmail.com"}],"homepage":"https://github.com/OrenGrinker/jira-mcp-server#readme","bugs":{"url":"https://github.com/OrenGrinker/jira-mcp-server/issues"},"dist":{"shasum":"af94ceda344994931b881eb397d9c847fa57758c","tarball":"https://registry.npmjs.org/@orengrinker/jira-mcp-server/-/jira-mcp-server-1.0.1.tgz","fileCount":83,"integrity":"sha512-qUY4sqVxpFUg21MqtYXJQVCg6IcZpe8aDmjIm8Hht7kaAGxxM9iJrGtngK6mXXNctHg8pA57LYewL9OoH0XNZg==","signatures":[{"sig":"MEQCIEGUMaJg/v2tiniSwbsVeTC0oMLdvCNKjZ7JIvmRPPF5AiB77hWNxGCfShOFDKMNE8RL+yuqkszIDmvvMZJMog9VDw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":276525},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"4a0dea14143a7f5e650de189ef657245707a39cb","scripts":{"dev":"tsx src/index.ts","test":"echo \"No tests yet\" && exit 0","build":"npm run clean && tsc && chmod +x dist/index.js","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"orengrinker","actor":{"name":"orengrinker","type":"user","email":"orengr4@gmail.com"},"email":"orengr4@gmail.com"},"repository":{"url":"git+https://github.com/OrenGrinker/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"A comprehensive Model Context Protocol server for Jira integration with issue management, board operations, time tracking, and project management capabilities","directories":{},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","rimraf":"^5.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.1_1750415885317_0.49270868228381337","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@orengrinker/jira-mcp-server","version":"1.0.2","keywords":["mcp","model-context-protocol","jira","atlassian","issue-tracking","project-management","ai","claude","automation"],"author":{"name":"Oren Grinker"},"license":"MIT","_id":"@orengrinker/jira-mcp-server@1.0.2","maintainers":[{"name":"orengrinker","email":"orengr4@gmail.com"}],"homepage":"https://github.com/OrenGrinker/jira-mcp-server#readme","bugs":{"url":"https://github.com/OrenGrinker/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"0a00d9e4f70eb435863de548e06d89aa4740b6f3","tarball":"https://registry.npmjs.org/@orengrinker/jira-mcp-server/-/jira-mcp-server-1.0.2.tgz","fileCount":83,"integrity":"sha512-pi89oh5vhK+C76NFMLC95N/c1EVKKny4lCdpzocYwowpgDul5bZ6fgTHSRnAFCNVXG5r1hs5km7vRQoPunPDOA==","signatures":[{"sig":"MEQCIFMdnrSdCO77npgt4kFrbs9ABP4vt+4vSoxAsZULcYD+AiBrikgas1F7vC30yxvzg1ZN/IkBcT39YQzJFwUnFsyUTQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":276641},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"4a0dea14143a7f5e650de189ef657245707a39cb","scripts":{"dev":"tsx src/index.ts","test":"echo \"No tests yet\" && exit 0","build":"npm run clean && tsc && chmod +x dist/index.js","clean":"rimraf dist","start":"node dist/index.js"},"_npmUser":{"name":"orengrinker","actor":{"name":"orengrinker","type":"user","email":"orengr4@gmail.com"},"email":"orengr4@gmail.com"},"repository":{"url":"git+https://github.com/OrenGrinker/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.2","description":"A comprehensive Model Context Protocol server for Jira integration with issue management, board operations, time tracking, and project management capabilities","directories":{},"_nodeVersion":"22.16.0","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","rimraf":"^5.0.0","typescript":"^5.0.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.2_1750416665045_0.10695129466592523","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@orengrinker/jira-mcp-server","version":"1.0.3","description":"A comprehensive Model Context Protocol server for Jira integration with issue management, board operations, time tracking, and project management capabilities","main":"dist/index.js","type":"module","scripts":{"build":"npm run clean && tsc && chmod +x dist/index.js","clean":"rimraf dist","dev":"tsx src/index.ts","start":"node dist/index.js","test":"echo \"No tests yet\" && exit 0"},"keywords":["mcp","model-context-protocol","jira","atlassian","issue-tracking","project-management","ai","claude","automation"],"author":{"name":"Oren Grinker"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/OrenGrinker/jira-mcp-server.git"},"bugs":{"url":"https://github.com/OrenGrinker/jira-mcp-server/issues"},"homepage":"https://github.com/OrenGrinker/jira-mcp-server#readme","engines":{"node":">=16.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","dotenv":"^16.5.0"},"devDependencies":{"@types/node":"^20.0.0","rimraf":"^5.0.0","tsx":"^4.0.0","typescript":"^5.0.0"},"_id":"@orengrinker/jira-mcp-server@1.0.3","gitHead":"78d1dacf3e7cda100ac78f6b2f1ff1cb1d41aa3a","types":"./dist/index.d.ts","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-IWbT08f/k8bA9G1GeFJaximhMknBwyliS3b1wcJXdcEJNj1+5Vu56RdjZa7kVXal5TcSLkaBgSQfcUE+VliSyw==","shasum":"a9d217025b0cbce04f7400f129842d3856efdd73","tarball":"https://registry.npmjs.org/@orengrinker/jira-mcp-server/-/jira-mcp-server-1.0.3.tgz","fileCount":53,"unpackedSize":194014,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQC9DyOXKPueRAftX/g4AgHOmwDaPsP/DKbAA7R1wfJo4QIgeBq2wSKFr6KIwHLo8HIWX3+lceyjeGfMW25x4XW+8uQ="}]},"_npmUser":{"name":"orengrinker","email":"orengr4@gmail.com","actor":{"name":"orengrinker","email":"orengr4@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"orengrinker","email":"orengr4@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-mcp-server_1.0.3_1750574634211_0.5029851172419582"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-20T10:32:03.976Z","modified":"2025-06-22T06:43:54.606Z","1.0.0":"2025-06-20T10:32:04.284Z","1.0.1":"2025-06-20T10:38:05.497Z","1.0.2":"2025-06-20T10:51:05.227Z","1.0.3":"2025-06-22T06:43:54.396Z"},"bugs":{"url":"https://github.com/OrenGrinker/jira-mcp-server/issues"},"author":{"name":"Oren Grinker"},"license":"MIT","homepage":"https://github.com/OrenGrinker/jira-mcp-server#readme","keywords":["mcp","model-context-protocol","jira","atlassian","issue-tracking","project-management","ai","claude","automation"],"repository":{"type":"git","url":"git+https://github.com/OrenGrinker/jira-mcp-server.git"},"description":"A comprehensive Model Context Protocol server for Jira integration with issue management, board operations, time tracking, and project management capabilities","maintainers":[{"name":"orengrinker","email":"orengr4@gmail.com"}],"readme":"# Jira MCP Server\n\nA comprehensive, production-ready Model Context Protocol (MCP) server for seamless Jira Cloud integration. This enhanced version provides advanced features, robust error handling, and extensive tooling for AI agents, automation systems, and custom applications.\n\n## 🚀 Features\n\n### Core Functionality\n- **Board Management**: List, filter, and manage Jira boards with detailed information\n- **Issue Operations**: Create, update, search, transition, and manage issues comprehensively\n- **User Management**: Search users, get user details, and manage assignments\n- **Project Administration**: View projects, get detailed project information\n- **Time Tracking**: Add and view work logs with flexible time formats\n- **Comment System**: Add comments with rich text support (ADF format)\n- **Server Information**: Monitor server status and health\n\n### Enhanced Features\n- **Rate Limiting**: Intelligent API request throttling to respect Jira limits\n- **Comprehensive Logging**: Configurable logging with multiple levels\n- **Error Handling**: Robust error handling with detailed error messages\n- **Input Validation**: Thorough validation of environment variables and inputs\n- **Modular Architecture**: Clean, maintainable codebase with service-based architecture\n- **TypeScript Support**: Full TypeScript implementation with comprehensive type definitions\n- **Rich Formatting**: Beautiful markdown tables and formatted responses\n- **Advanced Search**: Support for complex JQL queries with helpful examples\n\n## 🛠️ Requirements\n\n- **Node.js**: 18.0.0 or higher\n- **Jira Cloud**: Access to a Jira Cloud instance\n- **API Token**: Jira API Token ([create here](https://id.atlassian.com/manage-profile/security/api-tokens))\n\n## ⚙️ Environment Variables\n\nCreate a `.env` file or set these environment variables:\n\n```bash\nJIRA_BASE_URL=https://your-company.atlassian.net\nJIRA_EMAIL=your-email@company.com\nJIRA_API_TOKEN=your-jira-api-token\nLOG_LEVEL=INFO  # Optional: ERROR, WARN, INFO, DEBUG\n```\n\n## 🚀 Quick Start\n\n### Option 1: Using npx (Recommended)\n\n```bash\n# Run directly without installation\nnpx @orengrinker/jira-mcp-server\n\n# With environment variables\nJIRA_BASE_URL=https://company.atlassian.net \\\nJIRA_EMAIL=user@company.com \\\nJIRA_API_TOKEN=your-token \\\nnpx @orengrinker/jira-mcp-server\n```\n\n### Option 2: Claude Desktop Configuration\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"@orengrinker/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_BASE_URL\": \"https://your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@company.com\",\n        \"JIRA_API_TOKEN\": \"your-jira-api-token\",\n        \"LOG_LEVEL\": \"INFO\"\n      }\n    }\n  }\n}\n```\n\n### Option 3: Global Installation\n\n```bash\nnpm install -g @orengrinker/jira-mcp-server\njira-mcp-server\n```\n\n### Option 4: Local Development\n\n```bash\ngit clone https://github.com/OrenGrinker/jira-mcp-server.git\ncd jira-mcp-server\nnpm install\nnpm run build\nnode dist/index.js\n```\n\n## 🧰 Available Tools\n\n### Board Tools\n- `get_boards` - List all boards with optional filtering by type and project\n- `get_board_details` - Get comprehensive board information\n- `get_board_issues` - Get board issues with advanced filtering options\n\n### Issue Tools\n- `search_issues` - Search issues using JQL with flexible parameters\n- `get_issue_details` - Get comprehensive issue information\n- `create_issue` - Create new issues with full field support\n- `update_issue` - Update existing issues\n- `transition_issue` - Move issues between statuses\n- `add_comment` - Add comments with rich text support\n\n### User Tools\n- `get_current_user` - Get authenticated user information\n- `search_users` - Find users by name, email, or username\n- `get_user_details` - Get detailed user information\n\n### Project Tools\n- `get_projects` - List all accessible projects\n- `get_project_details` - Get comprehensive project information\n\n### Time Tracking Tools\n- `add_worklog` - Log work time with flexible formats\n- `get_worklogs` - View work logs for issues\n\n### System Tools\n- `get_server_info` - Get server status and information\n\n## 💡 Usage Examples\n\n### Natural Language Commands with Claude\n\nOnce configured with Claude Desktop, you can use natural language commands:\n\n```\n\"Show me all my open issues in high priority\"\n\"Create a new bug in PROJECT-X about login issues\"\n\"Move ticket ABC-123 to In Progress\"\n\"Log 2 hours of work on ABC-456 for code review\"\n\"Add a comment to ABC-789 saying the fix is deployed\"\n\"Show me all Scrum boards for the mobile project\"\n\"Get details for issue ABC-100 including comments and worklogs\"\n\"List all projects I have access to\"\n```\n\n### Using with MCP Inspector\n\n```bash\n# List all boards\nnpx @modelcontextprotocol/inspector \\\n  npx @orengrinker/jira-mcp-server \\\n  get_boards\n\n# Search for your issues\nnpx @modelcontextprotocol/inspector \\\n  npx @orengrinker/jira-mcp-server \\\n  search_issues \\\n  '{\"jql\": \"assignee=currentUser() AND status!=Done\"}'\n\n# Create a new issue\nnpx @modelcontextprotocol/inspector \\\n  npx @orengrinker/jira-mcp-server \\\n  create_issue \\\n  '{\"projectKey\": \"PROJ\", \"issueType\": \"Task\", \"summary\": \"New task from MCP\"}'\n```\n\n### JQL Query Examples\n\n```jql\n# Your open issues\nassignee = currentUser() AND status != Done\n\n# Recent issues in a project\nproject = \"MYPROJ\" AND created >= -7d\n\n# High priority bugs\npriority = High AND issuetype = Bug\n\n# Issues due this week\nduedate >= startOfWeek() AND duedate <= endOfWeek()\n\n# Unassigned issues in current sprint\nassignee is EMPTY AND sprint in openSprints()\n\n# Issues updated in the last 24 hours\nupdated >= -1d\n\n# Epic issues with their child stories\n\"Epic Link\" = PROJ-123 OR parent = PROJ-123\n```\n\n## 🔧 Configuration\n\n### Getting Your Jira API Token\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 (e.g., \"MCP Server\")\n4. Copy the generated token\n5. Use it in your environment variables\n\n### Permissions Required\n\nYour Jira user should have:\n- Browse projects permission\n- Create issues permission (for issue creation)\n- Edit issues permission (for updates and transitions)\n- Work on issues permission (for worklogs)\n- Add comments permission\n\n## 🏗️ Development\n\n### Setup\n\n```bash\ngit clone https://github.com/OrenGrinker/jira-mcp-server.git\ncd jira-mcp-server\nnpm install\n```\n\n### Development Scripts\n\n```bash\nnpm run dev          # Start development server with hot reload\nnpm run build        # Build for production\nnpm run clean        # Clean build directory\nnpm run start        # Start production server\nnpm run test         # Run tests (when available)\n```\n\n### Project Structure\n\n```\nsrc/\n├── index.ts              # Main server entry point\n├── jiraApiClient.ts      # Enhanced API client\n├── toolRegistry.ts       # Tool registration and routing\n├── types/\n│   └── index.ts         # TypeScript type definitions\n├── services/\n│   ├── index.ts         # Service exports\n│   ├── boardService.ts  # Board operations\n│   ├── issueService.ts  # Issue operations\n│   ├── userService.ts   # User operations\n│   ├── projectService.ts # Project operations\n│   ├── worklogService.ts # Worklog operations\n│   └── serverService.ts  # Server operations\n└── utils/\n    ├── logger.ts        # Logging utility\n    ├── rateLimiter.ts   # Rate limiting\n    ├── validation.ts    # Input validation\n    └── formatters.ts    # Response formatting\n```\n\n## 🔍 Troubleshooting\n\n### Common Issues\n\n1. **Authentication Failed**\n   - Verify your API token and email are correct\n   - Check that your Jira base URL is correct (should end with .atlassian.net for cloud)\n   - Ensure your API token hasn't expired\n\n2. **Permission Denied**\n   - Verify your Jira user has the required permissions\n   - Check project-level permissions for specific operations\n\n3. **Network Errors**\n   - Verify your Jira base URL is accessible\n   - Check firewall and proxy settings\n   - Ensure you're using HTTPS\n\n4. **Rate Limiting**\n   - The server includes built-in rate limiting\n   - If you hit Jira's rate limits, wait and retry\n   - Consider reducing concurrent requests\n\n### Debug Mode\n\nEnable debug logging:\n```bash\nexport LOG_LEVEL=DEBUG\n```\n\n## 🧪 Testing\n\n```bash\n# Test the server connection\nJIRA_BASE_URL=https://your-company.atlassian.net \\\nJIRA_EMAIL=your@email.com \\\nJIRA_API_TOKEN=your-token \\\nnode dist/index.js\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please follow these guidelines:\n\n1. **Fork the repository**\n2. **Create a feature branch**: `git checkout -b feature/amazing-feature`\n3. **Make your changes** following our coding standards\n4. **Add tests** for new functionality\n5. **Run the build**: `npm run build`\n6. **Commit changes**: `git commit -m 'Add amazing feature'`\n7. **Push to branch**: `git push origin feature/amazing-feature`\n8. **Open a Pull Request**\n\n### Coding Standards\n\n- Follow TypeScript best practices\n- Use meaningful variable and function names\n- Add JSDoc comments for public APIs\n- Follow conventional commit messages\n- Ensure all builds pass\n\n## 📊 Performance\n\n- **Rate Limiting**: Built-in rate limiting respects Jira API limits\n- **Connection Pooling**: Efficient HTTP connection management\n- **Error Recovery**: Automatic retry logic for transient failures\n- **Memory Efficient**: Streaming responses for large datasets\n\n## 🔐 Security\n\n- **No Credential Storage**: Uses environment variables only\n- **Input Validation**: All inputs are validated and sanitized\n- **Secure Defaults**: Follows security best practices\n- **Audit Trail**: Comprehensive logging for debugging\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🔗 Links\n\n- **GitHub Repository**: [https://github.com/OrenGrinker/jira-mcp-server](https://github.com/OrenGrinker/jira-mcp-server)\n- **NPM Package**: [@orengrinker/jira-mcp-server](https://www.npmjs.com/package/@orengrinker/jira-mcp-server)\n- **Jira Cloud REST API**: [Documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)\n- **Model Context Protocol**: [Specification](https://modelcontextprotocol.io/)\n- **Create API Tokens**: [Atlassian Guide](https://id.atlassian.com/manage-profile/security/api-tokens)\n\n## 🆘 Support\n\n- **Issues**: [GitHub Issues](https://github.com/OrenGrinker/jira-mcp-server/issues)\n- **Documentation**: Check this README and inline code documentation\n- **Feature Requests**: Open an issue with the \"enhancement\" label\n\n## 🏆 Acknowledgments\n\n- Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n- Inspired by the MCP community and best practices\n- Thanks to all contributors and users providing feedback","readmeFilename":"README.md"}