# Jira Mcp Server

> MCP server from samuelrizzo/jira-mcp-server.

- **Type:** MCP server
- **Install:** `agentstack add mcp-samuelrizzo-jira-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [samuelrizzo](https://agentstack.voostack.com/s/samuelrizzo)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [samuelrizzo](https://github.com/samuelrizzo)
- **Source:** https://github.com/samuelrizzo/jira-mcp-server

## Install

```sh
agentstack add mcp-samuelrizzo-jira-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Jira MCP Server

[](https://www.typescriptlang.org/)
[](https://nodejs.org/)
[](https://www.atlassian.com/software/jira)
[](https://www.npmjs.com/)
[](https://opensource.org/licenses/MIT)
[](http://makeapullrequest.com)

A Model Context Protocol (MCP) server for Jira integration. This server allows AI assistants like Claude to interact with Jira using MCP.

  

**Author:** Samuel Rizzo

[](https://github.com/samuelrizzo)
[](https://twitter.com/rizzo_exe)

## Features

- List all Jira projects
- Get detailed issue information
- Search issues by project and assignee
- List project members
- Check user's project membership and assigned issues
- Create new issues with custom fields
- List and query sprints with filtering options

## Installation

```bash
# Clone the repository
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# Install dependencies
npm install

# Build the project
npm run build
```

## Configuration

### MCP Server Configuration

Add the following configuration to your cursor/windsurf mcp settings file:

```json
{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}
```

### Setting up API Access

1. Generate a Jira API token:

   - Go to [Atlassian Account Settings](https://id.atlassian.com/manage-profile/security/api-tokens)
   - Click "Create API Token"
   - Give it a name and click "Create"
   - Copy the token (you'll need it for authentication)

2. Note your Jira host URL (e.g., `your-domain.atlassian.net`) and email address associated with your Atlassian account.
3. Add these credentials to your MCP server configuration.

## Available Tools

### 1. List Projects (`mcp_jira_list_projects`)

Lists all Jira projects the authenticated user has access to.

**Parameters:**

- `jiraHost`: Your Jira domain (e.g., 'your-domain.atlassian.net')
- `email`: Your Jira email
- `apiToken`: Your Jira API token

### 2. Get Issue Details (`mcp_jira_get_issue`)

Retrieves detailed information about a specific Jira issue.

**Parameters:**

- `issueKey`: The Jira issue key (e.g., 'PROJECT-123')
- `jiraHost`: Your Jira domain
- `email`: Your Jira email
- `apiToken`: Your Jira API token

### 3. Search Issues (`mcp_jira_search_issues`)

Searches for issues in a specific project, optionally filtered by assignee.

**Parameters:**

- `projectKey`: The Jira project key
- `assigneeName`: (Optional) Filter issues by assignee name
- `jiraHost`: Your Jira domain
- `email`: Your Jira email
- `apiToken`: Your Jira API token

### 4. List Project Members (`mcp_jira_list_project_members`)

Lists all members of a specific Jira project.

**Parameters:**

- `projectKey`: The Jira project key
- `jiraHost`: Your Jira domain
- `email`: Your Jira email
- `apiToken`: Your Jira API token

### 5. Check User Issues (`mcp_jira_check_user_issues`)

Checks if a user is a member of a project and lists their assigned issues.

**Parameters:**

- `projectKey`: The Jira project key
- `userName`: The display name of the user to check
- `jiraHost`: Your Jira domain
- `email`: Your Jira email
- `apiToken`: Your Jira API token

### 6. Create Issue (`mcp_jira_create_issue`)

Creates a new issue in a Jira project with specified details.

**Parameters:**

- `projectKey`: The Jira project key
- `summary`: The title/summary of the issue
- `description`: Detailed description of the issue
- `issueType`: (Optional) Type of issue (e.g., 'Task', 'Bug', 'Story'), defaults to 'Task'
- `assigneeName`: (Optional) The display name of the person to assign the issue to
- `reporterName`: (Optional) The display name of the person reporting the issue
- `sprintId`: (Optional) ID of the sprint to add the issue to
- `jiraHost`: Your Jira domain
- `email`: Your Jira email
- `apiToken`: Your Jira API token

### 7. List Sprints (`mcp_jira_list_sprints`)

Lists current sprints in Jira with filtering options.

**Parameters:**

- `boardId`: (Optional) Jira board ID to filter sprints by a specific board
- `projectKey`: (Optional) Project key to find sprints associated with the project
- `state`: (Optional) Sprint state to filter by (active, future, closed, or all), defaults to 'active'
- `jiraHost`: Your Jira domain
- `email`: Your Jira email
- `apiToken`: Your Jira API token

## Usage Examples

Here are some example queries you can use with Claude:

```
"List all Jira projects in PROJECT"
"Get details for issue PROJECT-123"
"Search for issues assigned to John in PROJECT"
"List all members of PROJECT"
"Check what issues are assigned to Jane in PROJECT"
"Create a new bug issue titled 'Login page error' in PROJECT"
"List active sprints for PROJECT"
```

## Continuous Development

This project is under active development. New tools and features are being added regularly to expand the integration capabilities with Jira. Future updates will include:

- Additional issue management tools
- Sprint and board management
- Advanced search and filtering options
- Custom field handling
- Workflow transitions
- And more!

Stay tuned by watching or starring the repository for updates.

## Contributing

This is an open-source project and contributions are welcome! To contribute:

1. Fork the repository
2. Create your feature branch
3. Make your changes
4. Submit a pull request

## Open Source

This code is completely open source. You are free to:

- Copy
- Modify
- Distribute
- Use commercially
- Use privately

No restrictions - do whatever you want with the code!

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [samuelrizzo](https://github.com/samuelrizzo)
- **Source:** [samuelrizzo/jira-mcp-server](https://github.com/samuelrizzo/jira-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-samuelrizzo-jira-mcp-server
- Seller: https://agentstack.voostack.com/s/samuelrizzo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.