Shoal - Jira MCP Server

Jira MCP server that actually works - without the bugs, hangs, and missing fields that ship in the official integration. Connects Claude directly to your Jira instance.

Features

  • Read, create, and update Jira issues
  • Add and edit comments on issues
  • Search using full JQL with configurable fields and pagination
  • Transition issue status through any workflow step
  • Manage labels
  • Create and resolve issue links (blocks, is blocked by, relates to)
  • Attach files to issues
  • Retrieve available transitions and link types for any issue
  • Supports Jira Cloud and self-hosted Jira (Data Center / Server)

Installation

Shoal is a free, open-source npm package. Install it globally with:

npm install -g @aquarium-tools/shoal

Then add shoal as an MCP server in your Claude Desktop or Claude Code configuration. Point it at your Jira instance using environment variables for credentials - no account or sign-up required.

Get Shoal on npm

Questions? See the FAQ.

Terms of Service