Connect your Jira account to Goodweek to manage issues, projects, sprints, and workflows directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Jira, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Jira integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Jira integration (app name: Composio- Jira Connector) uses OAuth 2.0 via Atlassian. No admin approval is required for most organizations. However, some Atlassian organizations have "Third-party app access via OAuth" disabled at the organization level.
⚠️ Atlassian security toggle
If users see an "OAuth app access restricted" error when connecting, an Atlassian Organization Admin must enable third-party app access from admin.atlassian.com → Security → Third-party app access.
⚠️ Jira Cloud only
This integration supports Jira Cloud only. Jira Data Center and Jira Server installations are not compatible.
User Connection
In Goodweek, go to Integrations.
Find Jira and click Connect.
You will be redirected to Atlassian, where you will be asked to sign in and authorize access.
Select the Jira site you want to connect and click Accept to return to Goodweek.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the projects and issues that your individual Jira account has permission to see.
This integration supports Jira Cloud only. Data Center and Server are not supported.
You can revoke Goodweek's access at any time from id.atlassian.com → Security → Connected apps → Composio.
Available Tools
Tool | Description | Type |
Search Issues Using JQL | Searches for Jira issues using JQL with pagination and field selection. | Read |
Search Issues (Advanced) | Advanced issue search supporting structured filters and raw JQL. | Read |
Get Issue | Retrieves a Jira issue by ID or key with customizable fields and expansions. | Read |
Bulk Fetch Issues | Retrieves up to 100 Jira issues by their IDs or keys in a single request. | Read |
Create Issue | Creates a new Jira issue (bug, task, story, etc.) in a specified project. | Write |
Bulk Create Issues | Creates up to 50 Jira issues in a single call with full feature support. | Write |
Edit Issue | Updates an existing Jira issue with new field values and operations. | Read |
Transition Issue | Moves a Jira issue to a different workflow state (e.g. To Do → In Progress → Done). | Read |
Assign Issue | Assigns a Jira issue to a user, the default assignee, or unassigns it. | Read |
Get Transitions | Retrieves available workflow transitions for a Jira issue. | Read |
List Issue Comments | Retrieves paginated comments from a Jira issue. | Read |
Get Comment | Retrieves a specific comment by ID from a Jira issue. | Read |
Add Comment | Adds a rich-text comment to an existing Jira issue. | Write |
Update Comment | Updates the text or visibility of an existing Jira comment. | Write |
Add Attachment | Uploads and attaches a file to a Jira issue. | Write |
Get Attachment | Retrieves the binary content of a Jira attachment by ID. | Read |
Link Issues | Links two Jira issues using a specified link type with an optional comment. | Write |
Get Issue Link Types | Retrieves all configured issue link types from Jira. | Read |
Add Worklog | Adds a worklog (time tracking entry) to a Jira issue. | Write |
Get Worklogs | Retrieves worklogs for a specified Jira issue. | Read |
Get all Projects | Retrieves all visible projects using the paginated Jira API. | Read |
Get Project | Retrieves details of a Jira project by its ID or key. | Read |
Create Project | Creates a new Jira project with required lead, template, and type configuration. | Write |
Get Project Versions | Retrieves all versions for a Jira project. | Read |
Create Version | Creates a new version for releases or milestones in a Jira project. | Write |
List Boards | Retrieves paginated Jira boards with filtering and sorting options. | Read |
Create Board | Creates a new Jira board (kanban, scrum, or agility). | Write |
List Sprints | Retrieves paginated sprints from a Jira board with optional state filtering. | Read |
Get Sprint | Retrieves detailed information about a specific sprint by its ID. | Read |
Create Sprint | Creates a new sprint on a Jira board with optional start/end dates and goal. | Write |
Move Issues to Sprint | Moves one or more Jira issues to a specified active sprint. | Read |
Get Current User | Retrieves information about the currently authenticated Jira user. | Read |
Get Issue Types | Retrieves all Jira issue types available to the user. | Read |
Get Issue Statuses | Retrieves all issue statuses associated with workflows in Jira. | Read |
Get Fields | Retrieves Jira issue field metadata, including custom field IDs. | Read |
Delete Issue | Permanently and irreversibly deletes a Jira issue by its ID or key. | ⚠️ Destructive |
Delete Comment | Permanently deletes a specific comment from a Jira issue. | ⚠️ Destructive |
Delete Attachment | Permanently deletes an attachment from Jira by its ID. | ⚠️ Destructive |
Delete Worklog | Deletes a worklog entry from a Jira issue. | ⚠️ Destructive |
Delete Version | Deletes a Jira version and optionally reassigns its issues. | ⚠️ Destructive |
Use Cases
Create and update issues from conversations. Log new Jira issues — bugs, tasks, or stories — with the right project, type, and fields directly from a Goodweek conversation, without navigating the Jira UI.
Search and triage issues using JQL. Run JQL queries from Goodweek to surface overdue issues, unassigned tasks, or sprint backlog items and act on them without opening Jira.
Transition issues through workflows. Move issues between statuses (e.g. In Progress → Done) directly from Goodweek to keep sprint boards and workflows up to date.
Log time and add comments. Record worklogs and add comments to issues from Goodweek after completing work, keeping issue history accurate without switching tools.
Troubleshooting
"OAuth app access restricted" when connecting
Your Atlassian organization has restricted third-party app access. An Atlassian Organization Admin must enable it from admin.atlassian.com → Security → Third-party app access.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Jira integration from the Goodweek Admin Panel under the Integrations tab.