{"_id":"@ashishoraon/jira-mcp-server","name":"@ashishoraon/jira-mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ashishoraon/jira-mcp-server","version":"0.1.0","description":"Model Context Protocol (MCP) Server for Jira integration","main":"dist/index.js","type":"module","scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc && node dist/index.js"},"keywords":["jira","mcp","model-context-protocol","atlassian"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.7.0","axios":"^1.6.2","dotenv":"^16.3.1","yup":"^1.3.2"},"devDependencies":{"@types/node":"^22.13.10","typescript":"^5.3.3"},"_id":"@ashishoraon/jira-mcp-server@0.1.0","gitHead":"5f0cd51c53adc91d7c6ce89f82fec73059b9bebd","_nodeVersion":"20.11.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-QpuHYJIT/KpZD0KkjkmS0BCnNbNir3HsorNZtRFRVDVB3QRiVP+y3KsQObHZcHDP6XRCLMNNjVqzutpMN+Pphg==","shasum":"bc5c16fba8f847f3047d0035baee8c7d67a376c7","tarball":"https://registry.npmjs.org/@ashishoraon/jira-mcp-server/-/jira-mcp-server-0.1.0.tgz","fileCount":46,"unpackedSize":184234,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGKIreir8Tb1XI45RCWPh8KjYU6ZzqHopC5WpeFgzBFxAiBw6A15OTsffk4KrMeGz14INor2wriUF2Ce1/AZhALfxQ=="}]},"_npmUser":{"name":"ashishoraon","email":"ashish.oraon200591@gmail.com"},"directories":{},"maintainers":[{"name":"ashishoraon","email":"ashish.oraon200591@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jira-mcp-server_0.1.0_1762248709910_0.47252911119012353"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-04T09:31:49.826Z","0.1.0":"2025-11-04T09:31:50.104Z","modified":"2025-11-04T09:31:50.413Z"},"maintainers":[{"name":"ashishoraon","email":"ashish.oraon200591@gmail.com"}],"description":"Model Context Protocol (MCP) Server for Jira integration","keywords":["jira","mcp","model-context-protocol","atlassian"],"license":"MIT","readme":"# Jira MCP Server\n\n\n\n[](https://www.typescriptlang.org/)\n[](https://nodejs.org/)\n[](https://www.atlassian.com/software/jira)\n[](https://www.npmjs.com/)\n[](https://opensource.org/licenses/MIT)\n[](http://makeapullrequest.com)\n\n
\n\nA Model Context Protocol (MCP) server for Jira integration. This server allows AI assistants like Claude to interact with Jira using MCP.\n\n\n
![\"Skills\"](\"https://skillicons.dev/icons?i=ts,nodejs,git\")
\n
\n\n[](https://github.com/samuelrizzo)\n[](https://twitter.com/rizzo_exe)\n\n
\n\n## Features\n\n- List all Jira projects\n- Get detailed issue information\n- Search issues by project and assignee\n- List project members\n- Check user's project membership and assigned issues\n- Create new issues with custom fields\n- List and query sprints with filtering options\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/samuelrizzo/jira-mcp-server.git\ncd jira-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n```\n\n## Configuration\n\n### MCP Server Configuration\n\nAdd the following configuration to your cursor/windsurf mcp settings file:\n\n```json\n{\n \"mcpServers\": {\n \"jira-mcp\": {\n \"command\": \"node\",\n \"args\": [\"./dist/index.js\"],\n \"env\": {\n \"JIRA_HOST\": \"your-domain.atlassian.net\",\n \"JIRA_EMAIL\": \"your-email@example.com\",\n \"JIRA_API_TOKEN\": \"your-api-token-here\"\n }\n }\n }\n}\n```\n\n### Setting up API Access\n\n1. Generate a Jira API token:\n\n - Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)\n - Click \"Create API Token\"\n - Give it a name and click \"Create\"\n - Copy the token (you'll need it for authentication)\n\n2. Note your Jira host URL (e.g., `your-domain.atlassian.net`) and email address associated with your Atlassian account.\n3. Add these credentials to your MCP server configuration.\n\n## Available Tools\n\n### 1. List Projects (`mcp_jira_list_projects`)\n\nLists all Jira projects the authenticated user has access to.\n\n**Parameters:**\n\n- `jiraHost`: Your Jira domain (e.g., 'your-domain.atlassian.net')\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n### 2. Get Issue Details (`mcp_jira_get_issue`)\n\nRetrieves detailed information about a specific Jira issue.\n\n**Parameters:**\n\n- `issueKey`: The Jira issue key (e.g., 'PROJECT-123')\n- `jiraHost`: Your Jira domain\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n### 3. Search Issues (`mcp_jira_search_issues`)\n\nSearches for issues in a specific project, optionally filtered by assignee.\n\n**Parameters:**\n\n- `projectKey`: The Jira project key\n- `assigneeName`: (Optional) Filter issues by assignee name\n- `jiraHost`: Your Jira domain\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n### 4. List Project Members (`mcp_jira_list_project_members`)\n\nLists all members of a specific Jira project.\n\n**Parameters:**\n\n- `projectKey`: The Jira project key\n- `jiraHost`: Your Jira domain\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n### 5. Check User Issues (`mcp_jira_check_user_issues`)\n\nChecks if a user is a member of a project and lists their assigned issues.\n\n**Parameters:**\n\n- `projectKey`: The Jira project key\n- `userName`: The display name of the user to check\n- `jiraHost`: Your Jira domain\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n### 6. Create Issue (`mcp_jira_create_issue`)\n\nCreates a new issue in a Jira project with specified details.\n\n**Parameters:**\n\n- `projectKey`: The Jira project key\n- `summary`: The title/summary of the issue\n- `description`: Detailed description of the issue\n- `issueType`: (Optional) Type of issue (e.g., 'Task', 'Bug', 'Story'), defaults to 'Task'\n- `assigneeName`: (Optional) The display name of the person to assign the issue to\n- `reporterName`: (Optional) The display name of the person reporting the issue\n- `sprintId`: (Optional) ID of the sprint to add the issue to\n- `jiraHost`: Your Jira domain\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n### 7. List Sprints (`mcp_jira_list_sprints`)\n\nLists current sprints in Jira with filtering options.\n\n**Parameters:**\n\n- `boardId`: (Optional) Jira board ID to filter sprints by a specific board\n- `projectKey`: (Optional) Project key to find sprints associated with the project\n- `state`: (Optional) Sprint state to filter by (active, future, closed, or all), defaults to 'active'\n- `jiraHost`: Your Jira domain\n- `email`: Your Jira email\n- `apiToken`: Your Jira API token\n\n## Usage Examples\n\nHere are some example queries you can use with Claude:\n\n```\n\"List all Jira projects in PROJECT\"\n\"Get details for issue PROJECT-123\"\n\"Search for issues assigned to John in PROJECT\"\n\"List all members of PROJECT\"\n\"Check what issues are assigned to Jane in PROJECT\"\n\"Create a new bug issue titled 'Login page error' in PROJECT\"\n\"List active sprints for PROJECT\"\n```\n\n## Continuous Development\n\nThis project is under active development. New tools and features are being added regularly to expand the integration capabilities with Jira. Future updates will include:\n\n- Additional issue management tools\n- Sprint and board management\n- Advanced search and filtering options\n- Custom field handling\n- Workflow transitions\n- And more!\n\nStay tuned by watching or starring the repository for updates.\n\n## Contributing\n\nThis is an open-source project and contributions are welcome! To contribute:\n\n1. Fork the repository\n2. Create your feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Open Source\n\nThis code is completely open source. You are free to:\n\n- Copy\n- Modify\n- Distribute\n- Use commercially\n- Use privately\n\nNo restrictions - do whatever you want with the code!\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-4c323ee74c49b0c11791dcc6bfacc57c"}