Jira
Capture Jira issues and let the agent search, create, and update them
The Jira integration connects your Atlassian Jira site to Modem. It captures issue and comment activity in real time so it can be analyzed and linked to the people behind it, and it gives the Modem Agent the ability to search, create, update, and comment on issues directly from chat.
Prerequisites
- Admin access in the Modem organization where you want to connect Jira
- Access to the Atlassian Jira site you want to connect, with permission to authorize apps
- A Modem organization (Jira is available on every plan)
Setup
Start the connection
Go to Settings → Integrations → Jira in your Modem dashboard and click Connect Jira.
Authorize Modem
You’ll be redirected to Atlassian to authorize Modem. Review the requested permissions and approve. If your Atlassian account can access more than one Jira site, Modem can’t choose between them yet and the connection fails. Contact support@modem.ai if this happens.
Choose projects to monitor
Back in Modem, pick which Jira projects to monitor from the project list. You can filter by project type (Software, Service, Business, Discovery) and toggle projects on or off at any time. Start narrow and expand as needed.
After authorization, Modem registers a webhook on your Jira site and begins receiving activity for the projects you selected.
What Gets Captured
Issues and comments
Modem captures issue activity for your monitored projects as it happens:
- New and updated issues
- Comments added or edited on those issues
The issue summary is used as the title for each captured conversation, so it shows up under a readable heading, with comments threaded beneath it.
Issue metadata
Each captured update is stored alongside the current state of its issue, including:
- Status and status category (e.g. To Do, In Progress, Done)
- Issue type (bug, story, task, etc.) and priority
- Reporter / creator and assignee
- Created and updated timestamps
- Jira issue URL for jumping back to the source issue
People
Modem resolves issue authors to Modem people profiles using their email address when Jira returns one. This gives you a unified view of each person’s activity across Jira and your other connected sources, and rolls activity up to the companies behind them.
Real-Time Capture
Jira capture is real-time: Modem starts ingesting activity from the moment you connect and select projects. New issues and comments are captured as Jira sends webhook events. There is no historical backfill of past issues today.
What the Agent Can Do
With Jira connected, you can ask the Modem Agent to work with your issues. Read operations run on demand; write operations require your approval before they execute.
- Search issues by keyword, project, status, or raw JQL
- List projects on your connected site
- Read full issue details by key (e.g.
ENG-123) - Create or update issues from feedback conversations (requires approval)
- Add comments to existing issues (requires approval)
Example Prompts
These work from the dashboard, Slack DMs, or by mentioning @modem in a channel.
Simple:
Advanced:
Troubleshooting
Issues aren't appearing
First confirm the integration shows a healthy status in Settings → Integrations → Jira, and that the relevant project is toggled on in the project list. Then allow a few minutes for webhook delivery and processing, and make sure the issue had a change (new issue, update, or comment) since connecting.
Connection shows an error or asks you to re-authorize
Open Settings → Integrations → Jira to see the error detail. If Modem prompts you to Authorize or Re-authorize, the access has expired or the required permissions changed; click through to grant access again. If the error persists, contact support@modem.ai.
Agent can't find or act on issues
- Verify Jira is connected and healthy in Settings → Integrations → Jira - Make sure the issue exists on the site you connected - Be specific with project keys or names - Remember that creating issues and adding comments require approval, so check for a pending approval prompt
Authors aren't linking to people
Issue authors are matched to Modem people by email address. If Jira doesn’t return an email for the author, their activity won’t be linked automatically.
Disconnecting
To disconnect Jira:
- Go to Settings → Integrations → Jira
- Click Disconnect
This removes the connection and deletes the webhook from your Jira site, so new activity is no longer synced and the agent can no longer act on Jira. Historical data remains in Modem after disconnecting.