productivityoauth2

Jira

Issue tracking and agile project management.

Verdict

Jira via MCP is the heavyweight issue-tracker integration — more complex schema than Linear, more workflow customisation, more places the model can get confused. It's not a graceful integration but it is the right one when your team is on Jira and you want AI-assisted ticket work. What we notice: Jira's flexibility (custom fields, workflows per project, complex JQL) means the MCP works best when you give the model precise context. "Find all P1 bugs in the X project assigned to me" works if the model knows the project key and the priority field. Generic "find my urgent issues" can land on the wrong field. Updates work; transitions through complex workflows occasionally need a more capable model (Sonnet 4.7 or GPT-5). Best for: orgs already running Jira where the AI integration meets the team where they are; sprint planning summaries (what's planned, what's at risk, what carried over); ticket triage and label cleanup; cross-project queries that would otherwise require manual JQL. Avoid for: greenfield project setup (Linear has a cleaner data model for AI to reason about); workflows where the AI needs to navigate complex permission schemes (Jira's permission matrix is hard for both humans and models); strict-compliance environments where AI ticket creation needs an audit trail. Practical frame: free with a Jira account on most plans; OAuth handles auth. Token cost is moderate — Jira issues are smaller than Notion docs but the model often loads many of them per query. Budget $0.05-0.50 per non-trivial query.

Common use cases

  • File bugs from customer support chats
  • Bulk-create sprint tasks from planning notes
  • Assign issues during standup without switching tabs
  • Add comments with context from Slack threads
  • Track sprint progress and update goals

Integration

Vendor
Jira
Category
productivity
Auth
OAUTH2
Tools
46
Composio slug
jira

Tools

  • Add Attachment

    Uploads and attaches a file to a jira issue.

  • Add Comment

    Adds a comment using atlassian document format (adf) for rich text to an existing jira issue.

  • Add Watcher to Issue

    Adds a user to an issue's watcher list by account id.

  • Assign Issue

    Assigns a jira issue to a user, default assignee, or unassigns; supports email/name lookup.

  • Bulk Create Issues

    Creates multiple jira issues (up to 50 per call) with full feature support including markdown, assignee resolution, and priority handling.

  • Create Issue

    Creates a new jira issue (e.g., bug, task, story) in a specified project.

  • Create Project

    Creates a new jira project with required lead, template, and type configuration.

  • Create Sprint

    Creates a new sprint on a jira board with optional start/end dates and goal.

  • Create Version

    Creates a new version for releases or milestones in a jira project.

  • Delete Comment
    destructive

    Deletes a specific comment from a jira issue using its id and the issue's id/key; requires user permission to delete comments on the issue.

  • Delete Issue
    destructive

    Deletes a jira issue by its id or key.

  • Delete Version
    destructive

    Deletes a jira version and optionally reassigns its issues.

  • Delete Worklog
    destructive

    Deletes a worklog from a jira issue with estimate adjustment options.

  • Edit Issue

    Updates an existing jira issue with field values and operations. supports direct field parameters (summary, description, assignee, priority, etc.) that are merged with the fields parameter. direct parameters take precedence.

  • Find Users

    Searches for jira users by email, display name, or username to find account ids; essential for assigning issues, adding watchers, and other user-related operations.

  • Get All Issue Type Schemes

    Retrieves all jira issue type schemes with optional filtering and pagination.

  • Get all projects

    Retrieves all visible projects using the modern paginated jira api with server-side filtering and pagination support.

  • Get All Users

    Retrieves all users from the jira instance including active, inactive, and other user states with pagination support.

  • Get Comment

    Retrieves a specific comment by id from a jira issue with optional expansions.

  • Get Current User

    Retrieves detailed information about the currently authenticated jira user.

  • Get Issue

    Retrieves a jira issue by id or key with customizable fields and expansions.

  • Get Issue Link Types

    Retrieves all configured issue link types from jira.

  • Get Issue Property

    Retrieves a custom property from a jira issue by key.

  • Get Issue Remote Links

    Retrieves links from a jira issue to external resources.

  • Get Issue Resolutions

    Retrieves all available issue resolution types from jira.

  • Get Issue Statuses

    Retrieves all available issue statuses from jira with details.

  • Get issue types

    Retrieves all jira issue types available to the user using the modern api v3 endpoint; results vary based on 'administer jira' global or 'browse projects' project permissions.

  • Get Issue Type Scheme

    Gets a jira issue type scheme by id with all associated issue types.

  • Get Issue Votes

    Fetches voting details for a jira issue; requires voting to be enabled in jira's general settings.

  • Get Issue Watchers

    Retrieves users watching a jira issue for update notifications.

  • Get Issue Worklogs

    Retrieves worklogs for a jira issue with user permission checks.

  • Get Project Versions

    Retrieves all versions for a jira project with optional expansion.

  • Get Transitions

    Retrieves available workflow transitions for a jira issue.

  • Get Worklogs

    Retrieves worklogs for a specified jira issue.

  • Link Issues

    Links two jira issues using a specified link type with optional comment.

  • List Boards

    Retrieves paginated jira boards with filtering and sorting options.

  • List Issue Comments

    Retrieves paginated comments from a jira issue with optional ordering.

  • List Sprints

    Retrieves paginated sprints from a jira board with optional state filtering.

  • Move Issues to Sprint

    Moves one or more jira issues to a specified active sprint.

  • Remove Watcher from Issue
    destructive

    Removes a user from an issue's watcher list by account id.

  • Search issues

    Advanced jira issue search supporting structured filters and raw jql.

  • Search Issues Using JQL (GET)

    Searches for jira issues using jql with pagination and field selection.

  • Search Issues Using JQL (POST)

    Searches for jira issues using jql via post request for complex queries; ideal for lengthy jql queries that might exceed url character limits

  • Send Notification for Issue

    Sends a customized email notification for a jira issue.

  • Transition Issue

    Transitions a jira issue to a different workflow state, with support for transition name lookup and user assignment by email.

  • Update Comment

    Updates text content or visibility of an existing jira comment.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Jira in the MCP catalog and click Connect. 3. You'll redirect to Atlassian's OAuth consent screen — sign in with an account that has project admin permissions. 4. Grant the requested scopes: read and write access to issues, projects, boards, and sprints. 5. Atlassian redirects you back to Switchy with a success confirmation. 6. Open any Space and type '@Jira create an issue in project ABC with summary Test Issue' to verify the connection works. 7. If the MCP responds with an issue key, you're ready — the integration can now read your projects, create issues, add comments, manage sprints, and attach files across your Jira instance.

What teammates see: by default, memories from Jira are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

File Bug from Thread

@Jira create a bug in project SUP with summary 'Login fails on Safari 17' and description from the last 5 messages in this thread. Assign it to the current on-call rotation.
Open in a Space →

Bulk Sprint Backlog

@Jira read the feature spec I pasted above and create 8-10 user stories in project ENG. Use priority Medium and assign them all to the next sprint.
Open in a Space →

Update Sprint Goal

@Jira show me the open issues in sprint 42 for project PROD, then update the sprint goal to match what we're realistically finishing by Friday.
Open in a Space →

Attach Meeting Notes

@Jira attach the meeting notes from today's sync to issue ENG-234. Include the decisions we made about the API redesign.
Open in a Space →

Assign and Notify

@Jira assign issue SUP-89 to sarah@example.com and add a comment explaining that this customer is on the enterprise plan and needs a response by EOD.
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@jira show me all open bugs assigned to me in the PLATFORM project, grouped by priority

Output

Found 12 open bugs in PLATFORM assigned to you: Critical (2): • PLATFORM-847: Database connection pool exhausted under load • PLATFORM-923: Auth token refresh fails for OAuth users High (5): • PLATFORM-891: API rate limit headers missing in responses • PLATFORM-902: Webhook delivery retries not respecting backoff • PLATFORM-915: Memory leak in background job processor • PLATFORM-931: Cache invalidation race condition on deploys • PLATFORM-944: Error logs not capturing full stack traces Medium (5): • PLATFORM-856: Dashboard charts load slowly with large datasets • PLATFORM-878: Export CSV button disabled for non-admin users • PLATFORM-889: Tooltip positioning breaks on mobile viewport • PLATFORM-912: Notification emails use wrong timezone • PLATFORM-938: Search autocomplete shows archived projects

Notes

This example demonstrates the MCP's search and filtering capabilities. Requires read:jira-work OAuth scope. The grouping and formatting are handled by the AI based on raw issue data returned by Jira's API—actual response structure depends on your project's custom fields and workflow states.

Prompt

@jira create a bug ticket in MOBILE project: login screen crashes on iOS 16 when biometric auth fails, assign to sarah@company.com, priority high

Output

Created MOBILE-1847: Login screen crashes on iOS 16 when biometric auth fails Type: Bug Priority: High Assignee: Sarah Chen (sarah@company.com) Status: To Do Reporter: You The issue has been added to the MOBILE project backlog. Sarah will receive a notification about the assignment. You can view the full ticket at https://yourcompany.atlassian.net/browse/MOBILE-1847

Notes

This showcases the Create Issue tool with assignee lookup by email. Requires write:jira-work scope. The MCP resolves the email to a Jira account ID automatically—if the email isn't found in your Jira instance, creation will fail with a clear error. Side-effect: creates a permanent ticket and triggers assignee notifications.

Prompt

@jira read the last 15 comments on BACKEND-456 and summarize what's blocking the release

Output

Based on 15 comments spanning the last 8 days, three blockers are preventing BACKEND-456 from releasing: 1. **Database migration rollback plan** (comments from Alex, Maria): The schema changes in PR #2891 don't have a tested rollback procedure. QA flagged this on Jan 8th; no update since. 2. **Performance regression in staging** (comments from Dev team): Load tests show 40% slower response times compared to v2.3. Jordan suspects the new caching layer; profiling in progress. 3. **Documentation incomplete** (comments from Product): API endpoint changes aren't reflected in the public docs. Technical writing team needs 2-3 days once the endpoint signatures are finalized. Most recent activity suggests the performance issue is the critical path—other blockers are waiting on that resolution.

Notes

This example pairs Jira's comment-fetching with AI synthesis to extract signal from discussion threads. Requires read:jira-work scope. The AI interprets comment content and timestamps—accuracy depends on how clearly your team documents blockers in comments. No side-effects; this is a read-only operation.

Use-case deep-dives

Customer support ticket escalation

When Jira MCP handles support-to-eng handoffs at 20+ tickets/day

A 6-person support team fields 30-40 customer issues daily and escalates 8-10 to engineering as Jira bugs. The Jira MCP wins here because OAuth2 keeps credentials out of shared prompts, and Bulk Create Issues lets the AI draft multiple tickets from a single support thread without rate-limit drama. The team uses Add Comment to append customer context and Assign Issue to route by component owner. The trade-off: if your support tool already has a native Jira integration (Zendesk, Intercom), that's faster for one-off escalations. But when you're triaging a batch of related issues in Switchy—say, five customers hit the same edge case—the MCP's bulk operations and attachment uploads make it the right call. Worth it if you escalate more than 15 tickets a week.

Sprint planning for distributed teams

Why this MCP scales sprint prep across time zones

A 9-person product team spans three time zones and runs two-week sprints with 40-60 stories per cycle. The Jira MCP is the move when async sprint planning happens in Switchy: the AI can Create Sprint, then use Bulk Create Issues to draft the backlog from a product brief or customer research doc. Add Watcher to Issue keeps stakeholders looped without manual tagging, and the 46-tool scope means you can also query sprint velocity or reassign mid-sprint without leaving the workspace. The boundary: if your team is under 5 people and everyone's in the same standup, the overhead of OAuth setup and learning the MCP's tool names isn't worth it—just use Jira's UI. But once you're coordinating across Slack threads and Google Docs with 8+ contributors, the MCP's batch operations and comment threading save 2-3 hours per sprint cycle.

Post-incident retrospective documentation

When Jira MCP turns incident notes into actionable tasks

An 11-person engineering team runs a post-incident review after a 90-minute outage and needs to convert the retrospective doc into 12 follow-up tasks across three Jira projects. The Jira MCP is built for this: the AI reads the incident timeline, uses Bulk Create Issues to generate tasks with correct project keys and priorities, then Add Attachment to link the runbook PDF. Create Issue handles the parent epic, and Assign Issue routes remediation work to the right on-call rotation. The limit: if your incidents are rare (under one per quarter) or your retro process is highly templated, the MCP's 46-tool surface area is overkill—a Zapier action or manual entry is faster. But for teams shipping daily with 2+ incidents per month, the MCP's ability to parse unstructured notes and create structured work in one pass justifies the OAuth setup. Buy if you're documenting more than 8 action items per incident.

Frequently asked

What can the Jira MCP do in Switchy?

The Jira MCP lets your AI agents create issues, add comments, assign tasks, manage sprints, and attach files directly in your Jira projects. It handles 46 different operations including bulk issue creation (up to 50 at once), watcher management, and project setup. Your agents can read issue details, update statuses, and coordinate work without leaving the conversation.

Do I need admin access to connect Jira via OAuth?

You don't need Jira admin rights to connect, but you do need permission to authorize OAuth apps in your Atlassian organization. The OAuth flow requests scopes for reading and writing issues, managing projects, and accessing user data. If your Atlassian admin has restricted third-party app installations, you'll need them to approve Switchy first.

Can the Jira MCP create custom fields or automation rules?

No. The MCP handles standard Jira objects like issues, comments, sprints, and attachments, but it can't create custom fields, automation rules, or modify project configurations beyond basic setup. For custom field values on existing fields, it works fine. For schema changes or workflow automation, use Jira's admin UI directly.

How is this different from just using Jira's API?

The MCP wraps Jira's REST API in natural language tools your AI agents understand. Instead of writing API calls with exact field IDs and JSON payloads, your agents describe what they want and the MCP translates it. It also handles assignee lookup by email or name, markdown-to-ADF conversion, and error recovery that raw API usage doesn't provide.

Should our product manager or engineering lead connect this?

Whoever owns your team's Jira projects should connect it. That person's OAuth token determines which projects the MCP can access and what permissions it inherits. If your PM manages the backlog and your engineers just execute, the PM should connect. If engineers triage and assign work, an engineering lead makes more sense.

Compare with

Compare with anything else →
Data last verified 7 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.