Jira
Issue tracking and agile project management.
Verdict
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 Commentdestructive
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 Issuedestructive
Deletes a jira issue by its id or key.
- Delete Versiondestructive
Deletes a jira version and optionally reassigns its issues.
- Delete Worklogdestructive
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 Issuedestructive
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
- 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
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.
@jira show me all open bugs assigned to me in the PLATFORM project, grouped by priority
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
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.
@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
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
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.
@jira read the last 15 comments on BACKEND-456 and summarize what's blocking the release
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.
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
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.
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.
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.