Jira MCP Server

Get the current authenticated user's info including accountId. Use this to get your account ID for assigning tickets. When multiple Jira instances are configured, use the 'instance' parameter to specify which one.

Fetch a Jira ticket by its key (e.g., MODS-12115). Returns full details including description, comments, attachments, and linked Figma designs.

Search Jira tickets using JQL. Returns detailed fields including dates, story points, labels, components, fix versions, time tracking, and parent. Examples: 'project = MODS AND status = Open'. When multiple Jira instances are configured, use the 'instance' parameter to specify which one.

Add a comment to a Jira ticket. Follow the server instructions' comment style rules.

Reply to a specific comment on a Jira ticket. Quotes the original comment and mentions the author.

Edit an existing comment on a Jira ticket (replaces the text). Follow the server instructions' comment style rules.

Delete a comment from a Jira ticket. This action is irreversible.

Change the status of a Jira ticket. Use targetStatus to transition by name (auto-handles intermediate steps like In Progress), transitionId for direct transition, or omit both to list available transitions.

Update fields on a Jira ticket. IMPORTANT: Only pass the fields you want to change. Omitted fields are left untouched. NEVER use em dashes (—) or en dashes (–) in text — use commas, periods, or rewrite the sentence instead.

Search for Jira users by name or email. Returns account IDs and display names. Use this to find users for mentions or assignments. When multiple Jira instances are configured, use the 'instance' parameter to specify which one.

Get status change history for a Jira ticket or multiple tickets via JQL. Returns all status transitions with timestamps and authors, plus computed metrics (cycle time, lead time, time in each status). Use issueKey for a single ticket, or jql for bulk retrieval. Instance is auto-detected from issueKe…

Add or update a Jira instance configuration. Saves to config and makes it available immediately without restart. To add a new instance, provide name + email + token + baseUrl. To update an existing instance (e.g. change projects or set as default), just provide name and the fields to change.

Remove a Jira instance configuration by name. Cannot remove the last remaining instance.

List all configured Jira instances with their names, URLs, project prefixes, and which is the default.

Search for available Jira teams by name. Returns matching teams with their IDs. Use this to find a team before setting it as default or assigning to a ticket. IMPORTANT: You MUST display the results in your chat response so the user can see them.

Create a new Jira issue (story, task, bug, epic, etc.). Returns the new issue key and URL. Use jira_search_users to get account IDs for assignee. NEVER use em dashes or en dashes in text fields.

Create a subtask under a parent Jira ticket. The subtask is created in the same project as the parent. NEVER use em dashes or en dashes in text fields.

Link two Jira tickets together with a relationship type. Use jira_get_link_types to discover available link type names. Common types: 'Blocks' (blocks/is blocked by), 'Relates' (relates to), 'Duplicate' (duplicates/is duplicated by), 'Cloners' (clones/is cloned by).

Delete a Jira ticket. This action is IRREVERSIBLE. If the ticket has subtasks, set deleteSubtasks to true or the deletion will fail.

Upload a file attachment to a Jira ticket. Provide either a local file path or base64-encoded file content.

List all available issue link types in the Jira instance. Use this to discover valid link type names before using jira_link_tickets.

List available status transitions for a Jira ticket. Use this to discover valid transition names/IDs before using jira_transition.

Remove a link between two Jira tickets. Fetches the issue to find the link ID automatically.

Remove an attachment from a Jira ticket by attachment ID or filename. If using filename, fetches the ticket to find the attachment ID.

Add a watcher to a Jira ticket. The watcher will receive notifications for changes on the ticket.

Remove a watcher from a Jira ticket.

Log time/work on a Jira ticket. Use Jira time format for timeSpent (e.g., '2h 30m', '1d', '30m').

Get work logs (time tracking entries) for a Jira ticket.

Clone/duplicate a Jira ticket. Creates a new ticket with the same summary, description, priority, labels, and components. Optionally links the clone to the original.

Move one or more tickets into a sprint. Use jira_get_sprints to find sprint IDs.

List sprints for an agile board. Returns sprint IDs, names, states, and dates.

List agile boards (Scrum or Kanban). Optionally filter by project key or board name.

List available issue types for a project. Useful before creating tickets to know valid issue type names.

List all available priority levels in the Jira instance.

List all components for a project. Useful before creating tickets to know valid component names.

List all versions/releases for a project. Useful for setting fixVersions on tickets.

List Confluence global spaces. Returns [{ key, name, id }]. On Cloud reuses the Jira instance credentials (Confluence base URL is <jiraBaseUrl>/wiki).

Get a single Confluence space by key. Returns space metadata including description and homepage.

Create a new Confluence global space. Provide key, name, and optional description (plain text).

Update a Confluence space's name or description. At least one of name/description must be provided.

Delete a Confluence space by key. This is asynchronous on Confluence Cloud — the call returns a long-running task.

Confluence CQL search for content. Builds CQL: text ~ "<query>" AND type = <type> [AND space = "<key>"] ORDER BY lastModified DESC.

List recently modified pages within a time window. Params: spaceKey (optional), sinceDays (default 30), limit (default 25).

List top-level (root) pages in a Confluence space, expanded with childTypes.page so consumers can tell which pages have children.

List direct child pages of a Confluence page, expanded with version, history and childTypes.page.

Fetch a full Confluence page. Returns v1 content (body.view, body.storage, space, ancestors, labels) merged with v2 body.atlas_doc_format when includeAdf is true. ADF is the only format that preserves table cell background colors on modern Cloud pages.

List comments on a Confluence page, expanded with body.view, version, created/updated history.

Add a footer comment to a Confluence page. Default format is 'text' (plain text / markdown-lite is wrapped in <p>…</p> with <br/> for single newlines). Use format='storage' to pass valid storage XHTML as-is.

Update an existing Confluence page. Title and/or body (storage XHTML). Version auto-bumps if omitted (fetches current version first). Confluence requires version.number = current + 1.

Create a new Confluence page. Body must be storage XHTML. Optional parentId nests under an existing page.

Delete a Confluence page by ID.

List labels on a Confluence page.

Add a label to a Confluence page.

Remove a label from a Confluence page.

List attachments on a Confluence page.

Upload a file as an attachment to a Confluence page. Provide either filePath or fileContent (base64) + fileName.

Download an attachment from a Confluence page by filename. Saves under ~/.config/jira-mcp/confluence-attachments/<pageId>/ and returns the local path.