jira_create_issue

Create new Jira issues by specifying project, summary, issue type, description, priority, assignee, and labels to track tasks, bugs, or stories in your workflow.

Instructions

Create a new Jira issue

Input Schema

TableJSON Schema

Name	Required	Description
`projectKey`	Yes	Project key
`summary`	Yes	Issue summary
`issueType`	Yes	Issue type (e.g., Bug, Task, Story)
`description`	No	Issue description
`priority`	No	Priority name
`assignee`	No	Assignee username
`labels`	No	Labels

Implementation Reference

src/index.ts:949-973 (handler)

MCP tool handler: validates input parameters using CreateIssueSchema, constructs the issue creation payload, calls jiraClient.createIssue, and returns the created issue as JSON.

case "jira_create_issue": {
  const {
    projectKey,
    summary,
    issueType,
    description,
    priority,
    assignee,
    labels,
  } = CreateIssueSchema.parse(args);
  const issue = await jiraClient.createIssue({
    fields: {
      project: { key: projectKey },
      summary,
      issuetype: { name: issueType },
      ...(description && { description }),
      ...(priority && { priority: { name: priority } }),
      ...(assignee && { assignee: { name: assignee } }),
      ...(labels && { labels }),
    },
  });
  return {
    content: [{ type: "text", text: JSON.stringify(issue, null, 2) }],
  };
}

src/index.ts:251-274 (registration)

Tool registration: defines the tool name, description, and input schema in the ListTools response.

{
  name: "jira_create_issue",
  description: "Create a new Jira issue",
  inputSchema: {
    type: "object",
    properties: {
      projectKey: { type: "string", description: "Project key" },
      summary: { type: "string", description: "Issue summary" },
      issueType: {
        type: "string",
        description: "Issue type (e.g., Bug, Task, Story)",
      },
      description: { type: "string", description: "Issue description" },
      priority: { type: "string", description: "Priority name" },
      assignee: { type: "string", description: "Assignee username" },
      labels: {
        type: "array",
        items: { type: "string" },
        description: "Labels",
      },
    },
    required: ["projectKey", "summary", "issueType"],
  },
},

src/index.ts:52-60 (schema)

Zod input validation schema matching the tool's inputSchema, used to parse arguments in the handler.

const CreateIssueSchema = z.object({
  projectKey: z.string().describe("Project key"),
  summary: z.string().describe("Issue summary"),
  issueType: z.string().describe("Issue type (e.g., Bug, Task, Story)"),
  description: z.string().optional().describe("Issue description"),
  priority: z.string().optional().describe("Priority name"),
  assignee: z.string().optional().describe("Assignee username"),
  labels: z.array(z.string()).optional().describe("Labels"),
});

src/jira-client.ts:57-62 (helper)

JiraClient helper method: sends POST request to /rest/api/2/issue endpoint to create the issue.

async createIssue(data: JiraCreateIssueRequest): Promise<JiraIssue> {
  return this.request<JiraIssue>("/issue", {
    method: "POST",
    body: JSON.stringify(data),
  });
}

src/types.ts:97-108 (schema)

TypeScript type definition for the createIssue request payload used by the JiraClient.

export interface JiraCreateIssueRequest {
  fields: {
    project: { key: string };
    summary: string;
    description?: string;
    issuetype: { name: string };
    priority?: { name: string };
    assignee?: { name: string };
    labels?: string[];
    [key: string]: unknown;
  };
}

Jira MCP Server