Jira MCP server

Connect Jira to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Jira MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list projects tool in Jira
  • Use the create filter tool in Jira
  • Use the search users tool in Jira
  • Use the search issues tool in Jira
  • Use the list boards tool in Jira
  • Use the move issues to sprint tool in Jira

Supported Tools

list_projects

List Projects

List Jira projects accessible to the authenticated user. Supports pagination for large project lists.

create_filter

Create Filter

Create a saved JQL filter in Jira. Filters can be used to quickly access frequently used search queries.

search_users

Search Users

Search for Jira users by name, username, or email. Useful for finding account IDs needed when assigning issues or other operations.

search_issues

Search Issues

Search for Jira issues using JQL (Jira Query Language). Returns matching issues with their key fields. Supports pagination and field selection.

list_boards

List Boards

List Jira boards (Scrum or Kanban). Optionally filter by board type or project.

move_issues_to_sprint

Move Issues to Sprint

Move one or more issues to a specific sprint. Issues will be removed from their current sprint and added to the target sprint.

create_issue

Create Issue

Create a new Jira issue in a specified project. Supports setting all standard fields including summary, description, assignee, priority, labels, components, and custom fields. Use the **issueTypeName** field for common types like "Task", "Bug", "Story", "Epic", or "Sub-task".

get_issue

Get Issue

Retrieve detailed information about a Jira issue by its key or ID. Returns the full issue data including all fields, status, assignee, reporter, comments, and changelog. Optionally expand additional information like transitions, rendered fields, or changelog.

list_sprints

List Sprints

List sprints for a given board. Optionally filter by sprint state (active, future, or closed).

add_comment

Add Comment

Add a comment to a Jira issue. Supports plain text or Atlassian Document Format (ADF) for rich text comments.

update_version

Update Version

Update a project version's details, release it, or archive it.

list_versions

List Versions

List versions (releases) for a Jira project. Returns version details including release status and dates.

get_transitions

Get Transitions

Get the available workflow transitions for an issue. Returns the transition IDs and names needed to move an issue to a new status via the Update Issue tool.

list_favourite_filters

List Favourite Filters

List the authenticated user's favourite saved JQL filters.

create_sprint

Create Sprint

Create a new sprint on a Scrum board. Optionally set start/end dates and a sprint goal.

update_issue

Update Issue

Update an existing Jira issue's fields, transition it to a new status, or reassign it. Combines field updates, workflow transitions, and assignment into a single flexible tool. Only provided fields will be updated.

create_version

Create Version

Create a new version (release) in a Jira project for release management.

log_work

Log Work

Log time spent on a Jira issue. Provide time as a human-readable string (e.g., "2h 30m") or in seconds. Optionally include a start timestamp and comment.

list_comments

List Comments

List comments on a Jira issue with pagination support.

delete_issue

Delete Issue

Permanently delete a Jira issue. Optionally delete all sub-tasks along with the parent issue. This action cannot be undone.

list_worklogs

List Worklogs

List worklogs for a Jira issue with pagination support.

delete_filter

Delete Filter

Delete a saved Jira JQL filter owned by the authenticated user.

get_filter

Get Filter

Retrieve a saved Jira JQL filter by ID.

delete_comment

Delete Comment

Delete a comment from a Jira issue.

update_filter

Update Filter

Update a saved Jira JQL filter's name, description, query, or favourite state.

delete_worklog

Delete Worklog

Delete a worklog from a Jira issue.

update_comment

Update Comment

Update an existing comment on a Jira issue. Supports plain text or Atlassian Document Format (ADF) bodies.

delete_version

Delete Version

Delete a Jira project version. Optionally move affected or fixed issues to replacement versions.

update_worklog

Update Worklog

Update time spent, start time, or comment for an existing Jira issue worklog.

list_sites

List Sites

List the Atlassian sites this Jira connection can access and show which site tools use by default. Use it when an issue, project, or board cannot be found, then pass the right site in the site input of other Jira tools.

Connect Jira to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Jira in Metorial. In your Metorial portal, enable the Jira MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Jira tools.

Run Jira through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Jira and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Jira tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Jira

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Sentry

Track, manage, and resolve application errors and performance issues. List, query, and bulk-update issues and error events with filters like status, assignment, and tags. Create and manage releases, associate commits, and upload source maps. Configure issue alert rules and metric alert rules with notification actions. Set up cron monitors to detect missed or failed scheduled jobs. Build custom dashboards with configurable widgets. Run ad-hoc Discover queries across errors and transactions for performance analysis. Manage organizations, teams, projects, and members. Provision users via SCIM. Access session replay data.

Technical notes for Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Frequently asked questions

Common questions about connecting Jira to AI agents with Metorial.

  1. How many tools does the Jira MCP server have?
    The Jira MCP server exposes 33 tools, including List Projects, Create Filter, Search Users. Each one is governed and traced through Metorial.
  2. Jira exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Jira MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Jira and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Jira MCP server yourself or use the hosted gateway.

Connect Jira to production AI agents

See how Metorial gives your team governed access to Jira, with tracing and security controls built in.