Jira, Outlook & Gemini
Integrations
Follow these steps to connect Alva to your work tools and manage your tickets, emails, and documents directly from the app.
.atlassian.net). For Jira Server or Data Center hosted by your organization, contact your IT admin.
Access Atlassian token management
Open the Atlassian API token management page in your browser:
https://id.atlassian.com/manage-profile/security/api-tokens
Sign in with your Atlassian account
Log in with the email address associated with your Jira Cloud workspace.
Create a new API token
Once logged in, you will see the API Tokens page. Click the "Create API token" button.
Name your token
A dialog will appear. Enter a descriptive name for your token, such as "Alva", so you can identify it later.
Copy the token immediately
Configure Alva
Fill in the three required fields:
https://yourcompany.atlassian.net. Make sure to include https://.
Access Microsoft security settings
Open the Microsoft account security page in your browser:
https://account.microsoft.com/security
Sign in with your Microsoft account
Log in with the email address you want to connect to Alva.
Access advanced security options
On the security dashboard, find and click "Advanced security options".
Enable two-step verification (if needed)
If two-step verification is not yet enabled, look for the "Two-step verification" section and click "Turn on". Follow Microsoft's prompts to set it up using your phone or authenticator app.
Find app passwords
In the advanced security options, scroll to the "App passwords" section and click "Create a new app password".
Create a new app password
A dialog will appear asking you to name the app password. Enter "Alva" and click "Create".
Copy the generated password
Configure Alva
Fill in the two required fields:
Access Google AI Studio
Open the Google AI Studio API key management page:
https://aistudio.google.com/apikey
Sign in with your Google account
Log in with any Google account. A personal Gmail account works perfectly.
Create an API key
On the API keys page, click the "Create API Key" button.
Select a project (or create one)
Google will ask you to associate the API key with a Google Cloud project. You can create a new one (recommended) or use an existing project.
Copy your API key
Configure Alva
Paste your API key:
With Gemini connected, you unlock the following features in Documents mode:
- PDF analysis and summarization
- Image text extraction (OCR)
- Contextual chat about documents
- Real-time streaming responses
Frequently Asked Questions
Common issues and answers about integrations
Check the following items:
- Email address: Make sure the email matches the one used for your Atlassian account (the same one you use to log in to Jira).
- API token: Verify that you copied the entire token without extra spaces. Tokens are long strings of characters.
- Site URL: Your Jira URL must include
https://and end with.atlassian.net. Example:https://mycompany.atlassian.net - Token expiration: API tokens can expire. If your token is old, create a new one from the Atlassian token management page.
The App passwords option only appears after you enable two-step verification (2FA). Go to your Microsoft account security settings and enable it first.
For organization accounts (Microsoft 365 business/enterprise), your IT administrator may have disabled app passwords at the organization level. In this case, contact your IT department and ask them to enable the "App passwords" feature in the Azure AD admin portal.
No problem — just create a new one:
- Jira: Go to Atlassian token management, revoke the old token if needed, and create a new one.
- Outlook: Go to your Microsoft security settings, navigate to Advanced security options > App passwords, delete the old one, and create a new app password.
- Gemini: Go to Google AI Studio to view your existing keys or create a new one.
Then update the credentials in Alva's settings.
Yes. API tokens and app passwords are the recommended authentication method by both Atlassian and Microsoft for third-party app access. Here is why they are secure:
- You never share your real password with Alva.
- Tokens and app passwords can be revoked at any time without affecting your main account.
- They provide independent access — revoking a token only disconnects that specific app.
- API tokens typically have limited scope compared to your full account credentials.
To disconnect Alva from your services:
- Jira: Go to Atlassian token management and click "Revoke" next to the "Alva" token.
- Outlook: Go to Microsoft security settings > Advanced security options > App passwords, and delete the "Alva" app password.
- Gemini: Go to Google AI Studio and delete the API key associated with Alva.
Once revoked, Alva will no longer be able to access those services until you create and configure new credentials.
Microsoft and Atlassian regularly update their interfaces. If the screenshots in this guide no longer match what you see:
- Use the search function on the settings page to find "API tokens" or "App passwords".
- Search Google for the latest instructions: "create Atlassian API token" or "create Microsoft app password".
- Check the official documentation: Atlassian docs or Microsoft docs.
The general process remains the same even if button positions or labels change slightly.
No, it is completely free. You do not need an existing Google Cloud account or billing setup. Google AI Studio lets you create a Gemini API key directly with your Google account (Gmail).
The free tier includes 15 requests per minute, which is more than enough for personal and professional daily use with Alva. No credit card is required at any step.
Check the following:
- Key format: Gemini API keys start with
AIza. Make sure you copied the complete key. - Quota exceeded: If you get a quota error, you have exceeded the free tier limit (15 requests/minute). Wait a moment and try again.
- Incomplete copy: API keys are long. Make sure you copied the entire key without truncation. Go back to AI Studio and copy it again.
- Key deleted: If you deleted the key from AI Studio, you need to create a new one.
Technically yes, a single Gemini API key can be used across multiple applications. However, it is recommended to create a separate key for each app. Here is why:
- Quota management: Each key shares the same quota. If another app uses up your free requests, Alva won't work until the quota resets.
- Security: If one app is compromised, you can revoke just that key without affecting others.
- Tracking: Separate keys let you monitor usage per application in Google AI Studio.
Creating additional keys is free and takes just a few seconds in AI Studio.