# Jira — Pipedream Connect

> Jira is the #1 agile project management tool used by teams to plan, track, release, and support great software with confidence

- API slug: `jira` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Productivity
- Website: https://www.atlassian.com/software/jira
- Managed OAuth scopes: `read:jira-work` · `manage:jira-project` · `read:jira-user` · `write:jira-work` · `read:me` · `offline_access` · `read:issue-details:jira` · `read:field:jira` · `read:project:jira` · `write:field.option:jira` · `read:custom-field-contextual-configuration:jira` · `read:jql:jira` · `manage:jira-webhook` · `write:sprint:jira-software` · `read:epic:jira-software` · `read:board-scope:jira-software` · `read:sprint:jira-software`
- This page (HTML): https://pipedream.com/apps/jira
- Tools: 39 actions · 4 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: jira`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "jira",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Attachment To Issue:
const result = await mcp.callTool({
  name: "jira-add-attachment-to-issue",
  arguments: {
    cloudId: "Cloud ID",
    issueIdOrKey: "Issue ID or Key",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Jira endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.atlassian.com/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuYXRsYXNzaWFuLmNvbS9tZQ?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "jira-add-attachment-to-issue",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    jira: { authProvisionId: "apn_xxxxxxx" },
    cloudId: "Cloud ID",
    issueIdOrKey: "Issue ID or Key",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (39)

### `jira-add-attachment-to-issue` — Add Attachment To Issue (Write)

Adds an attachment to an issue. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/add-attachment-to-issue.md

### `jira-add-comment-to-issue` — Add Comment To Issue (Write)

Adds a new comment to an issue. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/add-comment-to-issue.md

### `jira-add-multiple-attachments-to-issue` — Add Multiple Attachments To Issue (Write)

Adds multiple attachments to an issue. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/add-multiple-attachments-to-issue.md

### `jira-add-watcher-to-issue` — Add Watcher To Issue (Write)

Adds a user as a watcher of an issue by passing the account ID of the user, For example, 5b10ac8d82e05b22cc7d4ef5, If no user is specified the calling user is added. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/add-watcher-to-issue.md

### `jira-assign-issue` — Assign Issue (Write)

Assigns an issue to a user. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/assign-issue.md

### `jira-check-issues-against-jql` — Check Issues Against JQL (Read-only)

Checks whether one or more issues would be returned by one or more JQL queries. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/check-issues-against-jql.md

### `jira-count-issues-using-jql` — Count Issues Using JQL (Read-only)

Provide an estimated count of the issues that match the JQL. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/count-issues-using-jql.md

### `jira-create-custom-field-options-context` — Create Custom Field Options (Context) (Write)

Create a context for custom field options. See the documentation.

Full schema: https://pipedream.com/apps/jira/actions/create-custom-field-options-context.md

### `jira-create-future-sprint` — Create Future Sprint (Write)

Creates a future sprint. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/create-future-sprint.md

### `jira-create-issue` — Create Issue (Write)

Creates an issue or, where the option to create subtasks is enabled in Jira, a subtask. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/create-issue.md

### `jira-create-version` — Create Jira Version in Project (Write)

Creates a project version. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/create-version.md

### `jira-delete-project` — Delete Project (Write)

Deletes a project. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/delete-project.md

### `jira-download-attachment` — Download Attachment (Write)

Downloads a Jira issue attachment's binary content to the configured file-stash directory and returns its saved path plus the attachment's metadata (filename, mimeType, size, etc.). Use this after locating an attachment via Get Issue (its fields.attachment[] array lists each attachment's id…

Full schema: https://pipedream.com/apps/jira/actions/download-attachment.md

### `jira-get-all-projects` — Get All Projects (Read-only)

Gets metadata on all projects. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-all-projects.md

### `jira-get-board` — Get Board (Read-only)

Returns the board for the given board ID. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-board.md

### `jira-get-cloud-id` — Get Cloud ID (Read-only)

Lists all accessible Jira Cloud sites and their IDs. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-cloud-id.md

### `jira-get-current-user` — Get Current User (Read-only)

Returns the authenticated Jira user's account ID, display name, email, and active status. Call this first when the user says 'my issues', 'assigned to me', or needs their Jira identity. Use the returned accountId with Search Issues with JQL (e.g. assignee = '{accountId}') or Assign Issue. Requires…

Full schema: https://pipedream.com/apps/jira/actions/get-current-user.md

### `jira-get-issue` — Get Issue (Read-only)

Gets the details for an issue. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-issue.md

### `jira-get-issue-picker-suggestions` — Get Issue Picker Suggestions (Read-only)

Returns lists of issues matching a query string. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-issue-picker-suggestions.md

### `jira-get-issue-types` — Get Issue Types (Read-only)

Gets the available issue types. If a project ID is provided, returns issue types for that project. Otherwise, returns all issue types accessible to the user. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-issue-types.md

### `jira-get-sprint` — Get Sprint (Read-only)

Returns the sprint for a given sprint ID. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-sprint.md

### `jira-get-task` — Get Task (Read-only)

Gets the status of a long-running asynchronous task. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-task.md

### `jira-get-transitions` — Get Transitions (Read-only)

Gets either all transitions or a transition that can be performed by the user on an issue, based on the issue's status. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-transitions.md

### `jira-get-user` — Get User (Read-only)

Gets details of user. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-user.md

### `jira-get-users` — Get Users (Read-only)

Gets the details for a list of users. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/get-users.md

### `jira-list-board-issues` — List Board Issues (Read-only)

Returns all issues from a board, for the given board ID. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-board-issues.md

### `jira-list-boards` — List Boards (Read-only)

Returns all boards. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-boards.md

### `jira-list-epic-issues` — List Epic Issues (Read-only)

Returns all issues that belong to an epic on the given board. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-epic-issues.md

### `jira-list-epics` — List Epics (Read-only)

Returns all epics from a board, for the given board ID. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-epics.md

### `jira-list-issue-comments` — List Issue Comments (Read-only)

Lists all comments for an issue. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-issue-comments.md

### `jira-list-labels-options` — List Labels Options (Read-only)

Retrieves available options for the Labels field.

Full schema: https://pipedream.com/apps/jira/actions/list-labels-options.md

### `jira-list-sprint-issues` — List Sprint Issues (Read-only)

Returns all issues in a sprint. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-sprint-issues.md

### `jira-list-sprints` — List Sprints (Read-only)

Returns all sprints from a board, for the given board ID. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/list-sprints.md

### `jira-move-issues-to-sprint` — Move Issues to Sprint (Write)

Moves issues to a sprint, for a given sprint ID. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/move-issues-to-sprint.md

### `jira-search-issues-with-jql` — Search Issues with JQL (Read-only)

Search for issues using JQL (Jira Query Language). See the documentation

Full schema: https://pipedream.com/apps/jira/actions/search-issues-with-jql.md

### `jira-search-issues-with-jql-post` — Search Issues with JQL (POST) (Read-only)

Searches for issues using JQL with enhanced search capabilities. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/search-issues-with-jql-post.md

### `jira-transition-issue` — Transition Issue (Write)

Performs an issue transition and, if the transition has a screen, updates the fields from the transition screen. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/transition-issue.md

### `jira-update-comment` — Update Comment (Write)

Updates a comment. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/update-comment.md

### `jira-update-issue` — Update Issue (Write)

Updates an issue. A transition may be applied and issue properties updated as part of the edit. See the documentation

Full schema: https://pipedream.com/apps/jira/actions/update-issue.md

## Triggers (4)

### `jira-events` — New Event (Polling)

Emit new event when an event with subscribed event source triggered, See the documentation

Full schema: https://pipedream.com/apps/jira/triggers/events.md

### `jira-issue-created` — New Issue Created Event (Instant) (Polling)

Emit new event when an issue is created. Note that Jira supports only one webhook, if more sources are needed please use New Event source and select multiple events.

Full schema: https://pipedream.com/apps/jira/triggers/issue-created.md

### `jira-issue-deleted` — New Issue Deleted Event (Instant) (Polling)

Emit new event when an issue is deleted. Note that Jira supports only one webhook, if more sources are needed please use New Event source and select multiple events.

Full schema: https://pipedream.com/apps/jira/triggers/issue-deleted.md

### `jira-issue-updated` — New Issue Updated Event (Instant) (Polling)

Emit new event when an issue is updated. Note that Jira supports only one webhook, if more sources are needed please use New Event source and select multiple events.

Full schema: https://pipedream.com/apps/jira/triggers/issue-updated.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt