@avidian/mcp-jira
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@avidian/mcp-jirashow me all open issues in the current sprint"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@avidian/mcp-jira
MCP server for Jira Cloud — gives AI agents full context and control over Jira issues, projects, sprints, and workflows.
Installation
npm (requires Node.js ≥ 20)
npm install -g @avidian/mcp-jiraCompiled binary (no runtime needed)
sh -c "$(curl -fsSL https://raw.githubusercontent.com/avidianity/mcp-jira/main/install.sh)"Or download manually from GitHub Releases.
Related MCP server: Jira Cloud MCP Server
Configuration
Set these environment variables:
Variable | Description |
| Your Jira Cloud URL (e.g., |
| Email of the Jira user |
| API token (generate here) |
Usage
stdio (default — Claude Desktop, VS Code, Cursor)
mcp-jiraHTTP (Streamable HTTP transport)
mcp-jira --transport http --port 5485MCP client configuration
{
"mcpServers": {
"jira": {
"command": "mcp-jira",
"env": {
"JIRA_BASE_URL": "https://your-domain.atlassian.net",
"JIRA_USER_EMAIL": "you@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}Data formats (agent boundary)
Direction | Format | Notes |
Agent → MCP (rich text) | Markdown | Descriptions, comments, worklog comments. Converted to Jira ADF before REST calls. |
MCP → Agent (rich text) | Markdown | ADF from Jira is converted back to Markdown. Never raw ADF. |
MCP → Agent (structured data) | Lists, issue details, search hits, metadata, etc. Token-efficient vs JSON. | |
MCP → Agent (simple ack) | Plain text | Short success/error lines ( |
MCP → Agent (media) | Image / resource / path | Unchanged binary/path modes for attachments. |
Mentions in Markdown: @[accountId] or @[Display Name|accountId] (plain @Name is not a mention).
Tools
Issues
Tool | Description |
| Full issue details (Markdown description, TOON response) |
| Search via JQL with pagination |
| Create issue; supports components, fixVersions, custom |
| Update issue fields (same field support as create) |
| Delete an issue (optionally its subtasks) |
| Get available status transitions |
| Change issue status |
| Get the field-by-field change history |
Comments
Tool | Description |
| List comments with IDs; optional |
| Add a comment (Markdown, supports |
| Edit an existing comment |
| Delete a comment |
Worklogs
Tool | Description |
| List logged work on an issue |
| Log time (e.g. |
| Edit a work log entry |
| Delete a work log entry |
Participation
Tool | Description |
| List watchers on an issue |
| Add a watcher (self or by account) |
| Remove a watcher |
| Get vote count and voters |
| Vote for an issue |
| Remove your vote |
Links & attachments
Tool | Description |
| Link two issues together |
| List available issue link types |
| Delete a link by ID |
| Attach an external URL to an issue |
| List all attachments on an issue (shows image/media file IDs) |
| Fetch an image ( |
| Fetch a video ( |
| Fetch a text/source-file attachment as text |
| Fetch a binary file ( |
| Upload a file (text or base64 binary) |
| Delete an attachment by ID |
Boards & sprints
Tool | Description |
| List boards (optionally by project) |
| Get board configuration and columns |
| Get active/future/closed sprints for a board |
| Create a sprint |
| Start (activate) a sprint |
| Complete (close) a sprint |
| Move issues into a sprint |
| Move issues to the backlog |
| Add issues to an epic ( |
Projects
Tool | Description |
| List accessible projects |
| Get project details, issue types, components |
| List project versions/releases |
| Create a version |
| Update a version (e.g. mark released) |
| List project components |
| Create a component |
Users & metadata
Tool | Description |
| Search users by name or email |
| Get the authenticated user |
| List users assignable to a project/issue |
| Assign or unassign an issue |
| List issue types |
| List workflow statuses |
| List priorities |
| List fields incl. custom field IDs |
| Required/available fields for create |
| List labels |
Mentions
add_comment and update_comment accept Jira user mentions in the Markdown body:
@[accountId]— mention by account ID@[Display Name|accountId]— mention with a friendly label
Use get_user or list_assignable_users to look up account IDs.
Development
# Install dependencies
bun install
# Run in dev mode
bun run dev
# Type check
bun run typecheck
# Lint
bun run lint
# Format
bun run format
# Build for npm
bun run build
# Compile native binary
bun run compileLicense
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/avidianity/mcp-jira'
If you have feedback or need assistance with the MCP directory API, please join our Discord server