{"_id":"@carmeloricarte/jira-mcp-server","_rev":"7-cd2a3ea5325802da9fcefeff7b26269f","name":"@carmeloricarte/jira-mcp-server","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@carmeloricarte/jira-mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","_id":"@carmeloricarte/jira-mcp-server@1.0.0","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"dist":{"shasum":"02c323c0a265345f831b7c9280f1750e3c406791","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.0.0.tgz","fileCount":20,"integrity":"sha512-GEKyx9njkXvmXelxPW7FurO8JWe2MjXrN9G164Q/lWUIryGWcXOMo8Al+ui4wzUxoPMmVUZplMymxPFdpFTskg==","signatures":[{"sig":"MEUCIQDLqvB8JS3PwTqb10eEjrACWB+9hbb7gX+o39fC6X984wIgQxB+ukO4z62dphmwZybbPFrJiCtcMZf3I79stcWyvc0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":68111},"type":"module","gitHead":"c42a429b2d7c1d200e8e3e6b8f2860827bd17291","private":false,"scripts":{"test":"bun test","build":"bun build src/index.ts --outdir dist --target bun","start":"bun run src/index.ts","test:coverage":"bun test --coverage"},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"repository":{"url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.4","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.0_1770138037841_0.4803806750732562","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@carmeloricarte/jira-mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","_id":"@carmeloricarte/jira-mcp-server@1.0.1","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"a428f92a5225df71aa52aec0ea55909ae5aeb559","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.0.1.tgz","fileCount":3,"integrity":"sha512-2RW/BI8mphVRNh9R21SstDP68fvTcG600f0lxaXs+bBwWFjRzYshj5nRqR2QUUUIKGteF1sdoRgsvyE0z0uCaQ==","signatures":[{"sig":"MEUCIQCEC6W66JAGwp9zMcU83Q29Bz94hh+iR8VgPxLWqzlujwIgUiCUH7192s/UsgDJvOjJVaSt9pE+uScQ4myW1KJUrRU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":672752},"type":"module","gitHead":"ec6b6ba3c5d95b3d68de311dee83a074060b83bf","private":false,"scripts":{"test":"bun test","build":"bun build src/index.ts --outdir dist --target node","start":"bun run src/index.ts","typecheck":"tsc --noEmit","add-shebang":"node scripts/add-shebang.js","test:coverage":"bun test --coverage","prepublishOnly":"bun run build && bun run add-shebang"},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"repository":{"url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.4","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.1_1770141877780_0.9329794340610902","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@carmeloricarte/jira-mcp-server","version":"1.0.2","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","_id":"@carmeloricarte/jira-mcp-server@1.0.2","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"bf0fe4380884b78476508d92c63c86834abad6a7","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.0.2.tgz","fileCount":3,"integrity":"sha512-XJ2W1y30cej7RvrltgKQHdvV7XK56G39HETth4h99XfpgaGMAICDzk1D3toS5zTLKt2FDaC+Quf08mmeLv/A5w==","signatures":[{"sig":"MEYCIQCVd9D5rtNd04PkrHGS/iqwe6fPWHAip1MAk3Nj1yTY2AIhALUlWMz+6nTb7aZsCsTTfHiUMkJy2FYLkZXxEB7etp+G","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":673179},"type":"module","gitHead":"040de7776e4cce69d4b25e486be9afaa3a3bbf99","private":false,"scripts":{"test":"bun test","build":"bun build src/index.ts --outdir dist --target node","start":"bun run src/index.ts","typecheck":"tsc --noEmit","add-shebang":"node scripts/add-shebang.js","test:coverage":"bun test --coverage","prepublishOnly":"bun run build && bun run add-shebang"},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"repository":{"url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.4","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.2_1770144310790_0.8011074608323459","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@carmeloricarte/jira-mcp-server","version":"1.0.3","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","_id":"@carmeloricarte/jira-mcp-server@1.0.3","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"450367c5d1739b17323477e6e045c74b8a8c8a39","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.0.3.tgz","fileCount":3,"integrity":"sha512-r1LJS3cL+PHHlqJQa58GhMRfZFPOhxSvonRaKZnSJ/vvQ1mbS+PJqXxdqd2zJzB0S9B6I+y9puy/nkBHRH5ywg==","signatures":[{"sig":"MEQCIC1Me8qnn9RxiRVWbQxITyz5NvipU8ro4cwtPqdXg00GAiAUwLs5nWLe+++cbh7oErV5fZoqjP7vBksL6WGXDz1Smg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":674330},"type":"module","gitHead":"149a92ec3ab951cb043d425ddd0c1961223bb941","private":false,"scripts":{"lint":"biome lint --write .","test":"bun test","build":"bun build src/index.ts --outdir dist --target node","check":"biome check --write .","start":"bun run src/index.ts","format":"biome format --write .","typecheck":"tsc --noEmit","add-shebang":"node scripts/add-shebang.js","test:coverage":"bun test --coverage","prepublishOnly":"bun run build && bun run add-shebang"},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"repository":{"url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.4","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@biomejs/biome":"^2.3.14"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.0.3_1770287411914_0.013130554997523136","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@carmeloricarte/jira-mcp-server","version":"1.1.0","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","_id":"@carmeloricarte/jira-mcp-server@1.1.0","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"fd1adc5c2ffc4c46718758303deeb1c6c0b989f9","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.1.0.tgz","fileCount":3,"integrity":"sha512-Yvc2XNwnQFD1KQtkmutJsnp0zLHLIxaJRbZZ8rNBAPznDDxXAOEM3saJwXvb7RWYmhU3dLQrssFCgsGWv0OG4g==","signatures":[{"sig":"MEUCIQDaPbhG0L1j9Rzt1M0d57H4rltwcN66HDYmKjGGtSuwWgIgair+3QMfo8TAIiy8DB6UaQlqd+krreTePDNnpKpsGN8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":681296},"type":"module","gitHead":"805592d9f3c8c3815a3c87141de48318d1788a68","private":false,"scripts":{"lint":"biome lint --write .","test":"bun test","build":"bun build src/index.ts --outdir dist --target node","check":"biome check --write .","start":"bun run src/index.ts","format":"biome format --write .","typecheck":"tsc --noEmit","add-shebang":"node scripts/add-shebang.js","test:coverage":"bun test --coverage","prepublishOnly":"bun run build && bun run add-shebang"},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"repository":{"url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.4","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@biomejs/biome":"^2.3.14"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.1.0_1770375385862_0.7439101184161583","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@carmeloricarte/jira-mcp-server","version":"1.1.1","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","_id":"@carmeloricarte/jira-mcp-server@1.1.1","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/index.js"},"dist":{"shasum":"a90b7bcf675d59ac081f882d9fdefe557d2af081","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.1.1.tgz","fileCount":3,"integrity":"sha512-J+84JWPbWR7tgLOyf9iOuBaNMIVtphq+qyhtoib1jVZ9cRMZY4pw3ry4z2UnygfJIulz1qaioep5blL6XMEKYA==","signatures":[{"sig":"MEYCIQDQ+jR7rUW5U3EclUtNtMLph3h1riroT+awQdCOuT42SgIhAOvxu4+gCXu5Ni/7C2F/piCiBIuVi0gFC6+okjjo4lnO","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":681939},"type":"module","gitHead":"10d994a196610525f6e9c19fbfa2fc04ff4201e3","private":false,"scripts":{"lint":"biome lint --write .","test":"bun test","build":"bun build src/index.ts --outdir dist --target node","check":"biome check --write .","start":"bun run src/index.ts","format":"biome format --write .","typecheck":"tsc --noEmit","add-shebang":"node scripts/add-shebang.js","test:coverage":"bun test --coverage","prepublishOnly":"bun run build && bun run add-shebang"},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"repository":{"url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git","type":"git"},"_npmVersion":"10.9.4","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/bun":"latest","@biomejs/biome":"^2.3.14"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_1.1.1_1770383252846_0.2792996103478227","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@carmeloricarte/jira-mcp-server","version":"1.2.0","description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git"},"homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"type":"module","bin":{"jira-mcp-server":"dist/index.js"},"private":false,"scripts":{"start":"bun run src/index.ts","build":"bun build src/index.ts --outdir dist --target node","test":"bun test","test:coverage":"bun test --coverage","typecheck":"tsc --noEmit","lint":"biome lint --write .","format":"biome format --write .","check":"biome check --write .","add-shebang":"node scripts/add-shebang.js","prepublishOnly":"bun run build && bun run add-shebang"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","zod":"^3.24.0"},"devDependencies":{"@biomejs/biome":"^2.3.14","@types/bun":"latest"},"_id":"@carmeloricarte/jira-mcp-server@1.2.0","gitHead":"87ac94cf89971e84db242cef4b9cb41ef40532f9","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-ko3TKRPXTWPAHGjTR3vfWX6e/CzrsCXqR0lYS0red7n5W7FUizYpHiKreMYmuVNgETK/+cJQyPvBU19rIvw19A==","shasum":"f37be7e6f69c06e043979190a10342dca520f61c","tarball":"https://registry.npmjs.org/@carmeloricarte/jira-mcp-server/-/jira-mcp-server-1.2.0.tgz","fileCount":3,"unpackedSize":683484,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDsMQDC5BYPQ2F8RalmvDp8fDrRv3YPVJ5ibamX1D6FWwIgS4/lj3NPo05Jw30ITXmwaN13QCpHgTIdcnjgF6OETR0="}]},"_npmUser":{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"},"directories":{},"maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-mcp-server_1.2.0_1771241860113_0.07463773324383527"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-03T17:00:37.728Z","modified":"2026-02-16T11:37:40.382Z","1.0.0":"2026-02-03T17:00:37.990Z","1.0.1":"2026-02-03T18:04:37.959Z","1.0.2":"2026-02-03T18:45:10.961Z","1.0.3":"2026-02-05T10:30:12.104Z","1.1.0":"2026-02-06T10:56:26.026Z","1.1.1":"2026-02-06T13:07:33.016Z","1.2.0":"2026-02-16T11:37:40.274Z"},"bugs":{"url":"https://github.com/CarmeloRicarte/jira-mcp-server/issues"},"author":{"name":"Carmelo Ricarte Rocamora"},"license":"MIT","homepage":"https://github.com/CarmeloRicarte/jira-mcp-server#readme","keywords":["mcp","model-context-protocol","jira","atlassian","claude","claude-code","ai","llm","anthropic","project-management","issues","tickets","agile","scrum","sprint","kanban","api","integration","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/CarmeloRicarte/jira-mcp-server.git"},"description":"Model Context Protocol (MCP) server for Jira integration with Claude Code and AI assistants. Provides tools to interact with Jira API: create and manage issues, sprints, boards, projects and workflows.","maintainers":[{"name":"carmeloricarte","email":"carmeloricarterocamora@gmail.com"}],"readme":"# Jira MCP Server\n\n[![npm version](https://badge.fury.io/js/%40carmeloricarte%2Fjira-mcp-server.svg)](https://www.npmjs.com/package/@carmeloricarte/jira-mcp-server)\n\nA Model Context Protocol (MCP) server for Jira Cloud that enables AI assistants to interact with Jira issues.\n\n## Features\n\n| Tool | Description |\n|------|-------------|\n| **create_issue** | Create a new Jira issue (Story, Bug, Task, Epic, etc.) |\n| **get_issue** | Get detailed information about a specific Jira issue |\n| **list_issues** | Search for issues using JQL (Jira Query Language) |\n| **get_issue_fields** | Get all fields (including custom fields) for an issue |\n| **update_issue** | Update an existing issue (summary, description, assignee, priority, labels, custom fields) |\n| **delete_issue** | Delete a Jira issue by key or ID (with optional subtask deletion) |\n| **add_comment** | Add a comment to a Jira issue |\n| **get_transitions** | Get available status transitions for an issue |\n| **transition_issue** | Transition an issue to a new status |\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) 18+ **or** [Bun](https://bun.sh/) runtime\n- Jira Cloud account with API access\n- API token from [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n\n## Installation\n\nThe easiest way to use this MCP server is via `npx` or `bunx` - no installation required! Just configure your MCP client as shown below.\n\nIf you prefer to install globally:\n\n```bash\n# Using npm\nnpm install -g @carmeloricarte/jira-mcp-server\n\n# Using Bun\nbun install -g @carmeloricarte/jira-mcp-server\n```\n\n## Environment Variables\n\n> **Important:** You do NOT need to set environment variables at the system or user level. The MCP client will pass them to the server process when it starts. Just configure them in the `env` object of your MCP configuration.\n\n| Variable | Description | Example |\n|----------|-------------|---------|\n| `JIRA_HOST` | Your Jira Cloud domain (without https://) | `your-company.atlassian.net` |\n| `JIRA_EMAIL` | Email associated with your Atlassian account | `user@example.com` |\n| `JIRA_API_TOKEN` | API token generated from Atlassian | `ATATT3xF...` |\n\n---\n\n## MCP Client Configuration\n\n> **Note:** All examples below use `npx` (Node.js). If you prefer Bun, replace `\"command\": \"npx\"` with `\"command\": \"bunx\"` and remove the `\"-y\"` from args.\n\n### ⚠️ Windows Configuration\n\nOn Windows, you must wrap `npx` or `bunx` commands with `cmd /c`. Use this format:\n\n```json\n{\n  \"command\": \"cmd\",\n  \"args\": [\"/c\", \"npx\", \"-y\", \"@carmeloricarte/jira-mcp-server\"]\n}\n```\n\nOr with Bun:\n\n```json\n{\n  \"command\": \"cmd\",\n  \"args\": [\"/c\", \"bunx\", \"@carmeloricarte/jira-mcp-server\"]\n}\n```\n\n> **Important:** The package name must always be the **last argument** in the args array.\n\n---\n\n### Claude Code\n\n**Config file location:**\n- **macOS/Linux:** `~/.claude/settings.json`\n- **Windows:** `%USERPROFILE%\\.claude\\settings.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### VS Code (Copilot MCP Extension)\n\n**Config file location:**\n- **macOS/Linux:** `~/.vscode/mcp.json` or workspace `.vscode/mcp.json`\n- **Windows:** `%USERPROFILE%\\.vscode\\mcp.json` or workspace `.vscode\\mcp.json`\n\n```json\n{\n  \"servers\": {\n    \"jira\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Cursor\n\n**Config file location:**\n- **macOS:** `~/Library/Application Support/Cursor/User/globalStorage/cursor.mcp/mcp.json`\n- **Windows:** `%APPDATA%\\Cursor\\User\\globalStorage\\cursor.mcp\\mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Zed\n\n**Config file location:**\n- **macOS:** `~/.config/zed/settings.json`\n- **Windows:** `%APPDATA%\\Zed\\settings.json`\n\n```json\n{\n  \"language_models\": {\n    \"mcp_servers\": {\n      \"jira\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n        \"env\": {\n          \"JIRA_HOST\": \"your-company.atlassian.net\",\n          \"JIRA_EMAIL\": \"your-email@example.com\",\n          \"JIRA_API_TOKEN\": \"your-api-token\"\n        }\n      }\n    }\n  }\n}\n```\n\n---\n\n### OpenCode\n\n**Config file location:**\n- **macOS/Linux:** `~/.config/opencode/config.json`\n- **Windows:** `%USERPROFILE%\\.config\\opencode\\config.json`\n\n```json\n{\n  \"mcp_servers\": {\n    \"jira\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Codex (OpenAI CLI)\n\n**Config file location:**\n- **macOS/Linux:** `~/.codex/config.json`\n- **Windows:** `%USERPROFILE%\\.codex\\config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Windsurf (Codeium)\n\n**Config file location:**\n- **macOS:** `~/.codeium/windsurf/mcp_config.json`\n- **Windows:** `%USERPROFILE%\\.codeium\\windsurf\\mcp_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@carmeloricarte/jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-company.atlassian.net\",\n        \"JIRA_EMAIL\": \"your-email@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## Tool Examples\n\n### Create Issue\n\n```\nCreate a new Story in project PROJ with title \"Implement user authentication\"\n```\n\n```\nCreate an Epic in PROJ called \"[EPIC] Payment System\" with description \"Complete payment integration\"\n```\n\n### Get Issue\n\n```\nGet issue PROJ-123\n```\n\n### Search Issues with JQL\n\n```\nSearch for issues: project = PROJ AND status = \"In Progress\"\n```\n\n### Update Issue\n\n```\nUpdate PROJ-123: change priority to High and add labels \"urgent\", \"frontend\"\n```\n\n```\nUpdate the description of PROJ-123 to \"Updated requirements...\"\n```\n\n### Delete Issue\n\n```\nDelete issue PROJ-123\n```\n\n```\nDelete PROJ-456 and all its subtasks\n```\n\n### Add Comment\n\n```\nAdd comment \"Working on this now\" to PROJ-123\n```\n\n### Transition Issue\n\n```\nMove PROJ-123 to \"In Progress\"\n```\n\n---\n\n## Development\n\n### Clone and install dependencies\n\n```bash\ngit clone https://github.com/carmeloricarte/jira-mcp-server.git\ncd jira-mcp-server\nbun install\n```\n\n### Run tests\n\n```bash\nbun test\n```\n\n### Run tests with coverage\n\n```bash\nbun test --coverage\n```\n\n### Run the server standalone\n\n```bash\nJIRA_HOST=your-company.atlassian.net \\\nJIRA_EMAIL=your-email@example.com \\\nJIRA_API_TOKEN=your-token \\\nbun run start\n```\n\n---\n\n## Troubleshooting\n\n### Server not starting\n\n1. Verify Node.js 18+ or Bun is installed: `node --version` or `bun --version`\n2. Try running manually: `npx -y @carmeloricarte/jira-mcp-server` or `bunx @carmeloricarte/jira-mcp-server`\n3. Check for any error messages in your MCP client logs\n\n### Authentication errors\n\n1. Verify your API token is valid at [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Ensure `JIRA_HOST` does not include `https://`\n3. Verify `JIRA_EMAIL` matches the email used to generate the token\n\n### Empty results from list_issues\n\nThe server includes default fields (summary, status, priority, issuetype, assignee, updated). If you need additional fields, pass them in the `fields` parameter.\n\n---\n\n## Contributing\n\nContributions are welcome! If you'd like to contribute to this project:\n\n1. **Fork** the repository\n2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. **Commit** your changes (`git commit -m 'feat: add amazing feature'`)\n4. **Push** to the branch (`git push origin feature/amazing-feature`)\n5. **Open** a Pull Request\n\n### Guidelines\n\n- Follow the existing code style\n- Write tests for new features\n- Update documentation as needed\n- Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages\n\n### Reporting Issues\n\nFound a bug or have a feature request? Please [open an issue](https://github.com/carmeloricarte/jira-mcp-server/issues) with as much detail as possible.\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}