productivity
Jira MCP, CLI, and Lua Integration for AI Agents
Jira integration docs for AI agents: MCP gateway setup, Jira CLI commands, Lua API reference, credentials, and function schemas.
20 functions 12 read 8 write API token auth
Jira for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
jira- route_slug
jira- package
jira- auth_strategy
api_tokenAPI token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. Jira CLIHeadless setup and direct function calls. Jira MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Jira MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Jira.
Claude Code Jira MCP setup for Claude Code. Cursor Jira MCP setup for Cursor. Codex Jira MCP setup for Codex. OpenAI Agents Jira MCP setup for OpenAI Agents SDK. Claude Agent SDK Jira MCP setup for Claude Agent SDK. Vercel AI SDK Jira MCP setup for Vercel AI SDK. LangChain Jira MCP setup for LangChain. LangGraph Jira MCP setup for LangGraph. CrewAI Jira MCP setup for CrewAI. MCP clients Jira MCP setup for Generic MCP Clients.
Jira CLI Matrix
Use these pages for direct Jira CLI workflows in scripts, CI, cron, and agent wrappers.
CI Jira CLI for CI. Cron Jobs Jira CLI for cron jobs. Shell Scripts Jira CLI for shell scripts. Headless Automation Jira CLI for headless automation. Coding Agents Jira CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
jira.jira_create_issue | Write write | 7 | Create a new issue in a Jira project. Requires project_key, summary, and issue_type. Optionally set description, priority, assignee, and labels. |
jira.jira_get_issue | Read read | 1 | Get details for a specific Jira issue by its key (e.g. PROJ-123). Returns summary, status, assignee, description, and all fields. |
jira.jira_update_issue | Write write | 5 | Update an existing Jira issue. Provide the issue key and any fields to update (summary, description, priority, assignee). |
jira.jira_search_issues | Read read | 4 | Search for Jira issues using JQL (Jira Query Language). Examples: "project = PROJ AND status = Open", "assignee = currentUser() ORDER BY created DESC". |
jira.jira_add_comment | Write write | 2 | Add a comment to a Jira issue. Provide the issue key and the comment body text. |
jira.jira_list_comments | Read read | 1 | List all comments on a Jira issue. Returns comment body, author, and creation date. |
jira.jira_get_transitions | Read read | 1 | Get the available status transitions for a Jira issue. Returns transition IDs and target status names needed to change the issue status. |
jira.jira_transition_issue | Write write | 2 | Transition a Jira issue to a new status. Use jira_get_transitions first to find the available transition IDs for the issue. |
jira.jira_assign_issue | Write write | 2 | Assign a Jira issue to a user by their Atlassian account ID. Use jira_search_users to find account IDs. |
jira.jira_delete_issue | Write write | 1 | Delete a Jira issue by its key. This action is irreversible. |
jira.jira_list_projects | Read read | 2 | List Jira projects accessible to the authenticated user. Supports pagination with start_at and max_results. |
jira.jira_get_issue_types | Read read | 0 | Get all available issue types in Jira. Returns issue type names and IDs needed when creating issues. |
jira.jira_get_user | Read read | 1 | Get details for a specific Jira user by their Atlassian account ID. |
jira.jira_search_users | Read read | 2 | Search for Jira users by name or email. Returns account IDs needed for assigning issues. |
jira.jira_list_priorities | Read read | 0 | List all available issue priorities in Jira. Returns priority names and IDs needed when creating or updating issues. |
jira.jira_list_boards | Read read | 2 | List agile boards accessible to the authenticated user. Supports pagination with start_at and max_results. |
jira.jira_list_sprints | Read read | 2 | List sprints for a specific Jira board. Optionally filter by sprint state (active, closed, future). |
jira.jira_list_sprint_issues | Read read | 3 | List issues in a specific Jira sprint. Supports pagination with start_at and max_results. |
jira.jira_create_version | Write write | 5 | Create a new version (release) in a Jira project. Requires project_key and name. Optionally set description, start_date, and release_date. |
jira.jira_add_attachment | Write write | 3 | Add a file attachment to a Jira issue. Provide the issue key, filename, and file content. |