Skip to main content

Jira

Connect Toby to Atlassian Jira to search and read issues, comments, and projects from chat.

Jira ships as a first-party plugin bundled with Toby.app under ~/.toby/plugins/.

Prerequisites​

  • An Atlassian account with access to your Jira site
  • Your Jira site domain, such as your-company.atlassian.net
  • An Atlassian API token for that account

Get an API token​

  1. Open Atlassian API tokens.
  2. Choose Create API token (classic, without scopes — simplest for Toby).
  3. Give the token a name such as Toby.
  4. Copy the token and keep it safe until you paste it into Toby.

If your organization requires a scoped API token instead, Toby automatically retries via the Atlassian gateway (api.atlassian.com/ex/jira/{cloudId}) when the site URL rejects authentication. The token still needs Jira read scopes (for example read:jira-work).

Do not commit the token to git. Toby stores it in ~/.toby/credentials.json and masks it in the UI.

Configure​

Open Toby.app → Integrations → Jira and enter:

FieldDescription
Atlassian DomainYour Jira site domain, for example your-company.atlassian.net
EmailThe Atlassian account email for the API token
API TokenThe Atlassian API token

Save the configuration.

Connect​

Click Connect on the Jira detail page. Toby validates the domain, email, and API token, then marks Jira as connected.

Verify​

Return to Integrations in the sidebar. Jira should show as connected. Open the Jira detail page for any status notes about API reachability.

Chat capabilities​

Jira tools are read-only. Toby can:

  • Search issues with JQL (searchJiraIssues)
  • Fetch full issue details (getJiraIssue)
  • Read issue comments (getJiraIssueComments)
  • List accessible projects (listJiraProjects)

Example prompts:

  • “Find my unresolved Jira issues updated this week.”
  • “Show details and recent comments for PROJ-123.”
  • “List Jira projects I can access.”
  • “Search Jira for bugs in the current sprint ordered by priority.”

You can scope chat to Jira in Toby.app by selecting the Jira integration in the chat picker, or by leading with the integration name:

jira find unresolved issues assigned to me

JQL examples​

Useful JQL patterns:

assignee = currentUser() AND resolution = Unresolved ORDER BY updated DESC
project = PROJ AND status != Done
key = PROJ-123
type = Bug AND sprint in openSprints()

Search and comment results are paginated; Toby requests up to 100 items at a time when needed.

Disconnect​

Open the Jira detail page and click Disconnect.