Jira Integration

The Jira integration provides access to manage Jira issues, projects, sprints, and boards through the Integrate MCP server.

Installation

The Jira integration is included with the SDK:

import { jiraIntegration } from "integrate-sdk/server";

Setup

1. Create a Jira OAuth App

1. Go to Auth Developer Portal
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Jira integration to your server configuration. The integration automatically reads JIRA_CLIENT_ID and JIRA_CLIENT_SECRET from your environment variables:

import { createMCPServer, jiraIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    jiraIntegration({
      scopes: ["read:jira-work", "write:jira-work", "read:account", "offline_access"], // Optional
    }),
  ],
});

You can override the environment variables by passing explicit values:

jiraIntegration({
  clientId: process.env.CUSTOM_JIRA_ID,
  clientSecret: process.env.CUSTOM_JIRA_SECRET,
      scopes: ["read:jira-work", "write:jira-work", "read:account", "offline_access"], // Optional
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("jira");
const result = await client.jira.listProjects({});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, jiraIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [jiraIntegration()],
});

Configuration Options

Default Scopes

These defaults are applied unless you override scopes in the integration config:

• read:jira-work
• write:jira-work
• read:account
• offline_access

Tools

jira_list_projects

List projects

jira_get_project

Get project

jira_get_issue_types

Get issue types

jira_search_issues

Search issues

jira_get_issue

Get issue

jira_create_issue

Create issue

jira_update_issue

Update issue

jira_get_transitions

Get transitions

jira_transition_issue

Transition issue

jira_add_comment

Add comment

jira_assign_issue

Assign issue

jira_list_boards

List boards

jira_list_sprints

List sprints

Notes

• Category: Engineering
• Authentication mode: OAuth