# Jira + Spotify — Pipedream Connect

> Connect a user's Jira and Spotify accounts and expose tools for both apps directly in your product or your agent.

- Apps: Jira (`jira`) + Spotify (`spotify`)
- This page (HTML): https://pipedream.com/apps/jira/integrations/spotify
- One `external_user_id` owns both connected accounts, and each account stays independently revocable.

## One session, both toolsets (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,spotify`
- `x-pd-app-slug` takes a comma-separated list, so `jira,spotify` is one session on one transport. Both toolsets arrive from a single `listTools()`, and a tool is called exactly as it would be in a single-app session.

```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,spotify",
      },
    },
  },
)

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

const { tools } = await mcp.listTools()

// One list, both toolsets: Jira and Spotify tools arrive
// together, each keyed by its own app's slug.

// 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)

## Both apps from your backend

```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 externalUserId = "{external_user_id}" // any stable ID for this user in your system

const [jiraTools, spotifyTools] =
  await Promise.all([
    pd.components.list({ app: "jira" }),
    pd.components.list({ app: "spotify" }),
  ])

// One external user owns both connected accounts, so either app's tools
// run on their behalf with the same externalUserId.
```

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

## Jira

- 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`
- App page (HTML): https://pipedream.com/apps/jira
- Tools: 39 actions · 4 triggers

Full tool list, API proxy, and SDK quickstart: https://pipedream.com/apps/jira.md

### Actions (top 8 of 39)

- [Add Attachment To Issue](https://pipedream.com/apps/jira/actions/add-attachment-to-issue.md) — `jira-add-attachment-to-issue`
- [Add Comment To Issue](https://pipedream.com/apps/jira/actions/add-comment-to-issue.md) — `jira-add-comment-to-issue`
- [Add Multiple Attachments To Issue](https://pipedream.com/apps/jira/actions/add-multiple-attachments-to-issue.md) — `jira-add-multiple-attachments-to-issue`
- [Add Watcher To Issue](https://pipedream.com/apps/jira/actions/add-watcher-to-issue.md) — `jira-add-watcher-to-issue`
- [Assign Issue](https://pipedream.com/apps/jira/actions/assign-issue.md) — `jira-assign-issue`
- [Check Issues Against JQL](https://pipedream.com/apps/jira/actions/check-issues-against-jql.md) — `jira-check-issues-against-jql`
- [Count Issues Using JQL](https://pipedream.com/apps/jira/actions/count-issues-using-jql.md) — `jira-count-issues-using-jql`
- [Create Custom Field Options (Context)](https://pipedream.com/apps/jira/actions/create-custom-field-options-context.md) — `jira-create-custom-field-options-context`

### Triggers (4)

- [New Event](https://pipedream.com/apps/jira/triggers/events.md) — `jira-events`
- [New Issue Created Event (Instant)](https://pipedream.com/apps/jira/triggers/issue-created.md) — `jira-issue-created`
- [New Issue Deleted Event (Instant)](https://pipedream.com/apps/jira/triggers/issue-deleted.md) — `jira-issue-deleted`
- [New Issue Updated Event (Instant)](https://pipedream.com/apps/jira/triggers/issue-updated.md) — `jira-issue-updated`

## Spotify

- API slug: `spotify` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Entertainment
- Website: https://www.spotify.com/
- Managed OAuth scopes: `playlist-read-collaborative` · `playlist-modify-private` · `playlist-modify-public` · `playlist-read-private` · `user-modify-playback-state` · `user-read-currently-playing` · `user-read-playback-state` · `user-read-private` · `user-read-email` · `user-library-modify` · `user-library-read` · `user-follow-modify` · `user-follow-read` · `user-read-recently-played` · `user-top-read` · `streaming` · `app-remote-control` · `ugc-image-upload` · `user-read-playback-position`
- App page (HTML): https://pipedream.com/apps/spotify
- Tools: 20 actions · 4 triggers

Full tool list, API proxy, and SDK quickstart: https://pipedream.com/apps/spotify.md

### Actions (top 8 of 20)

- [Add Items to a Playlist](https://pipedream.com/apps/spotify/actions/add-items-to-playlist.md) — `spotify-add-items-to-playlist`
- [Create a Playlist](https://pipedream.com/apps/spotify/actions/create-playlist.md) — `spotify-create-playlist`
- [Get a Category's Playlists](https://pipedream.com/apps/spotify/actions/get-categorys-playlist.md) — `spotify-get-categorys-playlist`
- [Get a Playlist](https://pipedream.com/apps/spotify/actions/get-playlist.md) — `spotify-get-playlist`
- [Get a Playlist's Items](https://pipedream.com/apps/spotify/actions/get-playlist-items.md) — `spotify-get-playlist-items`
- [Get a Track](https://pipedream.com/apps/spotify/actions/get-track.md) — `spotify-get-track`
- [Get Album Tracks](https://pipedream.com/apps/spotify/actions/get-album-tracks.md) — `spotify-get-album-tracks`
- [Get All Tracks by Artist](https://pipedream.com/apps/spotify/actions/get-all-tracks-by-artist.md) — `spotify-get-all-tracks-by-artist`

### Triggers (4)

- [New Playlist](https://pipedream.com/apps/spotify/triggers/new-playlist.md) — `spotify-new-playlist`
- [New Saved Track](https://pipedream.com/apps/spotify/triggers/new-saved-track.md) — `spotify-new-saved-track`
- [New Track by Artist](https://pipedream.com/apps/spotify/triggers/new-track-by-artist.md) — `spotify-new-track-by-artist`
- [New Track in Playlist](https://pipedream.com/apps/spotify/triggers/new-track-in-playlist.md) — `spotify-new-track-in-playlist`

---

- Jira: https://pipedream.com/apps/jira.md · Spotify: https://pipedream.com/apps/spotify.md
- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt