{"_id":"@damoncoo/jira-mcp-server","_rev":"2-efe2f757de1f4419d2f22d216cb89e3e","name":"@damoncoo/jira-mcp-server","dist-tags":{"latest":"0.0.8"},"versions":{"0.0.7":{"name":"@damoncoo/jira-mcp-server","version":"0.0.7","keywords":["jira","mcp","llm","ai","server","model context protocol","jira api"],"author":{"url":"https://github.com/ParasSolanki","name":"Paras Solanki","email":"parassolanki151@gmail.com"},"license":"MIT","_id":"@damoncoo/jira-mcp-server@0.0.7","maintainers":[{"name":"damoncoo","email":"damoncoo@gmail.com"}],"homepage":"https://github.com/ParasSolanki/jira-mcp-server#readme","bugs":{"url":"https://github.com/ParasSolanki/jira-mcp-server/issues"},"bin":{"jira-mcp-server":"dist/app.js"},"dist":{"shasum":"0d972a77a63d361225da4cd30248934a8989f191","tarball":"https://registry.npmjs.org/@damoncoo/jira-mcp-server/-/jira-mcp-server-0.0.7.tgz","fileCount":4,"integrity":"sha512-5ai6IIaOnltNhlw9ebQf2wZb5lPT4YJWFu7lcM/Yvqf5N1X1iQNm4t0OaCiKg5nNBfdwhmijvtiLgUz9nu5P9A==","signatures":[{"sig":"MEUCIQDX+6RzU00e+YCmULwsF++ItHVz6Zk3Kd1YkXeZFF+zKAIgCahiB4qoHlfvKP8h6JvlkZnKVybFHWo1AE3eL7+tObE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":123810},"main":"dist/app.js","type":"module","_from":"file:damoncoo-jira-mcp-server-0.0.7.tgz","engines":{"node":">=22.12.0"},"scripts":{"dev":"dotenvx run -- tsx watch src/app.ts","lint":"eslint .","build":"rolldown -c rolldown.config.ts && shx chmod +x dist/*.js","format":"prettier '**/*.{cjs,mjs,ts,tsx,md,json}' --ignore-path ./.gitignore --ignore-unknown --write","release":"changeset version","inspector":"pnpm build && npx @modelcontextprotocol/inspector dist/app.js","typecheck":"tsc --noEmit","build:local":"dotenvx run -f .env.production -- pnpm build","pub:release":"pnpm build && changeset publish","format:check":"prettier '**/*.{cjs,mjs,ts,tsx,md,json}' --ignore-path ./.gitignore --ignore-unknown --check"},"_npmUser":{"name":"damoncoo","email":"damoncoo@gmail.com"},"_resolved":"/private/var/folders/x1/p7bjm8nn5lgb8zg0ry97vqwh0000gn/T/9b4c273ec1165363058f326caf31429e/damoncoo-jira-mcp-server-0.0.7.tgz","_integrity":"sha512-5ai6IIaOnltNhlw9ebQf2wZb5lPT4YJWFu7lcM/Yvqf5N1X1iQNm4t0OaCiKg5nNBfdwhmijvtiLgUz9nu5P9A==","repository":{"url":"git+https://github.com/ParasSolanki/jira-mcp-server.git","type":"git"},"_npmVersion":"10.5.0","description":"A model context protocol server for Jira API.","directories":{},"_nodeVersion":"20.12.0","dependencies":{"zod":"^3.24.2","neverthrow":"^8.2.0","@t3-oss/env-core":"^0.12.0","zod-to-json-schema":"^3.24.3","universal-user-agent":"^7.0.2","@modelcontextprotocol/sdk":"^1.7.0"},"_hasShrinkwrap":false,"packageManager":"pnpm@9.15.3","devDependencies":{"shx":"^0.3.4","tsx":"^4.19.3","prettier":"^3.5.3","rolldown":"1.0.0-beta.6","@eslint/js":"^9.21.0","typescript":"^5.7.2","@types/node":"^22.13.8","@changesets/cli":"^2.27.7","@dotenvx/dotenvx":"^1.38.3","typescript-eslint":"^8.25.0","rollup-plugin-swc3":"^0.12.1","eslint-plugin-neverthrow":"^1.1.4","@changesets/changelog-github":"^0.5.0"},"_npmOperationalInternal":{"tmp":"tmp/jira-mcp-server_0.0.7_1743523150083_0.9264693704442111","host":"s3://npm-registry-packages-npm-production"}},"0.0.8":{"name":"@damoncoo/jira-mcp-server","version":"0.0.8","description":"A model context protocol server for Jira API.","license":"MIT","type":"module","homepage":"https://github.com/ParasSolanki/jira-mcp-server#readme","author":{"name":"Paras Solanki","email":"parassolanki151@gmail.com","url":"https://github.com/ParasSolanki"},"bin":{"jira-mcp-server":"dist/app.js"},"main":"dist/app.js","packageManager":"pnpm@9.15.3","repository":{"type":"git","url":"git+https://github.com/ParasSolanki/jira-mcp-server.git"},"bugs":{"url":"https://github.com/ParasSolanki/jira-mcp-server/issues"},"engines":{"node":">=22.12.0"},"keywords":["jira","mcp","llm","ai","server","model context protocol","jira api"],"dependencies":{"@modelcontextprotocol/sdk":"^1.7.0","@t3-oss/env-core":"^0.12.0","neverthrow":"^8.2.0","universal-user-agent":"^7.0.2","zod":"^3.24.2","zod-to-json-schema":"^3.24.3"},"devDependencies":{"@changesets/changelog-github":"^0.5.0","@changesets/cli":"^2.27.7","@dotenvx/dotenvx":"^1.38.3","@eslint/js":"^9.21.0","@types/node":"^22.13.8","eslint-plugin-neverthrow":"^1.1.4","prettier":"^3.5.3","rolldown":"1.0.0-beta.6","rollup-plugin-swc3":"^0.12.1","shx":"^0.3.4","tsx":"^4.19.3","typescript":"^5.7.2","typescript-eslint":"^8.25.0"},"scripts":{"dev":"dotenvx run -- tsx watch src/app.ts","build":"rolldown -c rolldown.config.ts && shx chmod +x dist/*.js","build:local":"dotenvx run -f .env.production -- pnpm build","inspector":"pnpm build && npx @modelcontextprotocol/inspector dist/app.js","lint":"eslint .","typecheck":"tsc --noEmit","format":"prettier '**/*.{cjs,mjs,ts,tsx,md,json}' --ignore-path ./.gitignore --ignore-unknown --write","format:check":"prettier '**/*.{cjs,mjs,ts,tsx,md,json}' --ignore-path ./.gitignore --ignore-unknown --check","release":"changeset version","pub:release":"pnpm build && changeset publish"},"_id":"@damoncoo/jira-mcp-server@0.0.8","_integrity":"sha512-3Yujv2R7CDu/smqx9yrWovzA+wzTyNFvKPXOwDbodVObJLsVpU2YfQqaKpAXVgE2lNGa/OcJxfI/Y6tfnLK0ZQ==","_resolved":"/private/var/folders/x1/p7bjm8nn5lgb8zg0ry97vqwh0000gn/T/0043fe8f5fa202f18867b46000fe1a0d/damoncoo-jira-mcp-server-0.0.8.tgz","_from":"file:damoncoo-jira-mcp-server-0.0.8.tgz","_nodeVersion":"20.12.0","_npmVersion":"10.5.0","dist":{"integrity":"sha512-3Yujv2R7CDu/smqx9yrWovzA+wzTyNFvKPXOwDbodVObJLsVpU2YfQqaKpAXVgE2lNGa/OcJxfI/Y6tfnLK0ZQ==","shasum":"0965344b3e7f3cca86f37a6469e64d65ecbcba5f","tarball":"https://registry.npmjs.org/@damoncoo/jira-mcp-server/-/jira-mcp-server-0.0.8.tgz","fileCount":4,"unpackedSize":123843,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIG68AtXs3ePHHlH2FREB0/JEMv2N8HFCumqn4W/rLc7KAiEA20ObCsRYt11UfY7SdZNmz9g36kboHukxLzUeGr4Az34="}]},"_npmUser":{"name":"damoncoo","email":"damoncoo@gmail.com"},"directories":{},"maintainers":[{"name":"damoncoo","email":"damoncoo@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-mcp-server_0.0.8_1743525620376_0.18407372020892865"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-01T15:59:09.995Z","modified":"2025-04-01T16:40:20.720Z","0.0.7":"2025-04-01T15:59:10.299Z","0.0.8":"2025-04-01T16:40:20.567Z"},"bugs":{"url":"https://github.com/ParasSolanki/jira-mcp-server/issues"},"author":{"name":"Paras Solanki","email":"parassolanki151@gmail.com","url":"https://github.com/ParasSolanki"},"license":"MIT","homepage":"https://github.com/ParasSolanki/jira-mcp-server#readme","keywords":["jira","mcp","llm","ai","server","model context protocol","jira api"],"repository":{"type":"git","url":"git+https://github.com/ParasSolanki/jira-mcp-server.git"},"description":"A model context protocol server for Jira API.","maintainers":[{"name":"damoncoo","email":"damoncoo@gmail.com"}],"readme":"# Jira MCP Server\n\n![NPM Version](https://img.shields.io/npm/v/%40parassolanki%2Fjira-mcp-server) ![NPM Downloads](https://img.shields.io/npm/dw/%40parassolanki%2Fjira-mcp-server) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\nA [Model Context Protocol](https://github.com/modelcontextprotocol) Server for Jira.\n\nProvides integration with Jira through MCP, allowing LLMs to interact with it.\n\n[Jira REST Api Docs](https://developer.atlassian.com/server/jira/platform/rest)\n\n## Installation\n\n### Manual Installation\n\n> Note: Requires Node version to be 22.12.0 or above\n\n1. Create or get Jira Personal Access Token: [Guide](https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html)\n\n2. Add server config to Claude Desktop:\n\n   - MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json\n   - Windows: [Check this Guide](https://gist.github.com/feveromo/7a340d7795fca1ccd535a5802b976e1f)\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@parassolanki/jira-mcp-server@latest\"],\n      \"env\": {\n        \"JIRA_PERSONAL_ACCESS_TOKEN\": \"email@example.com:your_personal_jira_access_token\",\n        \"JIRA_BASE_URL\": \"jira_base_url\"\n      }\n    }\n  }\n}\n```\n\nFor Windows:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"cmd /c npx\",\n      \"args\": [\"-y\", \"@parassolanki/jira-mcp-server@latest\"],\n      \"env\": {\n        \"JIRA_PERSONAL_ACCESS_TOKEN\": \"email@example.com:your_personal_jira_access_token\",\n        \"JIRA_BASE_URL\": \"jira_base_url\"\n      }\n    }\n  }\n}\n```\n\n## Components\n\n### Tools\n\n1.  `list_projects`: List projects from Jira.\n\n    - Required inputs:\n      - `query` (optional string): A query string used to filter the returned projects.\n      - `maxResults` (optional number, max: 100): The maximum number of results to return.\n      - `expand` (optional string): Expand additional information in the response. (comma separated `description`, `lead`, `issueTypes`, `url`, `projectKeys`, `permissions` and `insight`).\n\n2.  `list_boards`: List boards from a project.\n\n    - Required inputs:\n      - `projectKeyOrId` (string): Key or Id of the project.\n      - `name` (optional string): Name of the project.\n      - `maxResults` (optional number, max: 100): The maximum number of results to return.\n      - `startAt` (optional number): The starting index of the returned boards.\n      - `type` (optional string): The type of boards. (can be one of `scrum` or `kanban`).\n\n3.  `list_sprints_from_board`: List sprints from a board.\n\n    - Required inputs:\n      - `boardId` (string): The ID of the board.\n      - `maxResults` (optional number, max: 100): The maximum number of results to return.\n      - `startAt` (optional number): The starting index of the returned boards.\n\n4.  `list_issues_from_sprint`: List issues from a sprint.\n\n    - Required inputs:\n      - `boardId` (string): The ID of the board.\n      - `sprintId` (string): The ID of the sprint.\n      - `maxResults` (optional number, max: 100): The maximum number of results to return.\n      - `startAt` (optional number): The starting index of the returned boards.\n      - `expand` (optional string): Expand additional information in the response. (comma separated `schema` and `names`).\n\n## Usage examples\n\nSome example prompts you can use to interact with Jira:\n\n1. \"Show me all Jira projects\" → execute the list_projects tool to see all available projects.\n2. \"What Kanban boards exist in the DEV project?\" → execute the list_boards tool with the DEV project key and type parameter set to \"kanban\".\n3. \"Show me all the sprints for board ID 123\" → execute the list_sprints_from_board tool to see all sprints associated with board 123.\n4. \"What issues are in sprint 456 on board 123?\" → execute the list_issues_from_sprint tool to see all issues in sprint 456 on board 123.\n5. \"Show me the first 50 issues from the current sprint on the Marketing board\" → first execute list_boards to find the Marketing board ID, then list_sprints_from_board to find the current sprint, then list_issues_from_sprint with maxResults=50.\n\n## Development\n\n1. Install dependencies:\n\n```shell\npnpm install\n```\n\n2. Configure Github Access token in `.env`:\n\n```shell\nJIRA_PERSONAL_ACCESS_TOKEN=email@example.com:your_personal_jira_access_token\nJIRA_BASE_URL=jira_base_url\n```\n\n3. Run locally with watch:\n\n```shell\npnpm dev\n```\n\n4. Build the server:\n\n```shell\npnpm build\n```\n\n5. Local debugging with inspector:\n\n```shell\npnpm inspector\n```\n\n## TODOS\n\n- [x] list_projects\n- [x] list_boards\n- [x] list_sprints_from_board\n- [x] list_issues_from_sprint\n- [ ] get_issue_by_id_or_key\n- [ ] create_issue\n- [ ] update_issue\n- [ ] delete_an_issue\n- [ ] archieve_an_issue\n- [ ] list_comments_from_issue\n- [ ] get_comment_from_issue_by_id\n- [ ] create_comment_in_issue\n- [ ] update_comment_of_issue\n- [ ] delete_comment_of_issue\n- [ ] list_subtasks_from_issue\n- [ ] get_user_by_username_or_key\n","readmeFilename":"README.md"}