TicketBridge is a lightweight automation tool that turns incoming support emails into Jira tickets using AI. Employees simply send an email to the IT department's mailbox, and TicketBridge automatically:
- Reads unread messages from the IT inbox.
- Uses AI (Google Gemini) to summarize and categorize the request.
- Creates a properly formatted Jira ticket with the relevant details.
This removes the need for non-technical staff to learn Jira — they just write an email, and the IT team gets an actionable ticket.
- Email Intake – Connects to your IT department’s Gmail inbox via IMAP.
- AI Analysis – Uses Google Gemini to summarize the issue, detect priority, project, issue type, and assignee.
- Jira Publishing – Creates a ticket in Jira with the extracted data and any attachments.
- Repeat – Checks the mailbox every minute for new, unread emails.
- Java 17+
- Gradle
- Gmail account with App Passwords
- Jira Cloud account and API token
- Google Gemini API key
./gradlew clean build run
Before running, configure your .env
file or environment variables:
# Google Gemini
GEMINI_API_KEY=AAAAAAAAAAAA_AAAAAA_AAAAAAAAAAAAAA-AAAAA
# Gmail (IT department inbox)
GMAIL_HOST=imap.gmail.com
GMAIL_ADDRESS=[email protected]
GMAIL_APP_PASSWORD=aaaabbbbccccdddd
# Jira
JIRA_URL=https://kerbsod.atlassian.net/
JIRA_MAIL=[email protected]
JIRA_TOKEN=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA...
Note:
- Your Gmail account must have IMAP enabled.
- Use an App Password, not your Gmail password.
- Jira token can be generated in Account Settings → Security → API Tokens.
- Frictionless – No Jira onboarding for non-technical staff.
- Automated – Tickets appear in Jira within a minute of email arrival.
- AI-Powered – Summaries and categorizations are generated automatically.
- Extensible – Easy to adapt to other ticketing platforms or AI models.