Help · version 0.1.13

Connect mail and calendars

Open Settings → Accounts & Data Sources → Mail and calendar accounts. A connection opens a browser page served by your Personal Hub. Sign in with the provider there and approve only the feature you selected.

You can connect more than one Google or Microsoft account. Once one is connected, choose Add account for another. Each account appears by name below its provider. Use Enable mail or Enable calendar on that account to grant the other feature; make sure you sign in to the same provider account in the browser. If an account needs a fresh login, choose Reconnect account.

Your provider tokens and imported content stay in the Personal Hub. Gravify's account and licence service does not receive them. If a provider says the Gravify app is unavailable or unverified, the product-wide provider setup is incomplete; changing your local account will not fix that.

Google

Choose Mail for Gmail or Calendar for Google Calendar. Sign in to the Google account you want to connect and review the permissions shown by Google. Mail requests read and send access; Gravify never sends a message without your explicit action. Calendar synchronization requests read access. Connecting one feature does not silently grant the other; choose the other button later if you want both.

Google may show the Gravify consent screen again when a new permission is needed. If synchronization later reports that authorization is required, reconnect that feature from the same page.

Microsoft

Choose Mail for Outlook or Microsoft 365 mail, or Calendar for its calendar. Personal Microsoft accounts and organizational accounts can use the same connection flow. An organization administrator can still block third-party applications or require administrator consent.

Thunderbird: university and work mail

Choose Thunderbird in Settings → Accounts & Data Sources → Mail and calendar accounts. This free, read-only connection uses the Thunderbird already running on your Personal Hub computer. It can help when direct Microsoft connection requires organization approval, provided the organization permits Thunderbird itself. It cannot override an organization policy that blocks that client.

For example, Politecnico di Milano's official mail instructions list Thunderbird among the supported clients and require the mailbox's primary address. Its Thunderbird configuration guide may require your university login. Other organizations can apply different rules, including restrictions on extensions. Follow the current instructions from your administrator; being allowed to use Thunderbird does not automatically authorize its community bridge extension.

You can choose Open Thunderbird on Hub, or ask the Gravify assistant to open it when you need mail from a Thunderbird-connected account. This opens Thunderbird on the Hub computer, including when you ask through the dedicated owner chat. It does not install the extension, sign in or confirm new mail has finished importing. Previously imported mail remains readable in Gravify while Thunderbird is closed.

  1. Install Thunderbird on the Hub computer, add the mail account and complete its provider login personally. Open a message there to verify the account works.
  2. On a Windows Hub, choose Prepare mail connection, review the extension notice and choose Install extension. Gravify verifies and prepares the included Thunderbird MCP 0.9.2 extension. If Windows asks, approve installation on the Hub computer. Close and reopen Thunderbird if it was already running. Other Hub systems, or existing managed extension policies, can use the Manual setup instructions instead. The community extension requests full Thunderbird and computer access and is installed for Thunderbird profiles belonging to the Hub Windows user. In its Options, allow the accounts you want to expose and keep communication review protection enabled. Gravify itself only calls reading tools.
  3. Leave Thunderbird open. In Gravify choose Find Thunderbird accounts, select the account, your email address, and the folders to read. Inbox starts selected. Choose the last 30 days, the last year, or all available history, then Connect for reading.

The connected account card always shows the saved folders, the history start and the last successful sync. These choices survive closing the screen. Request sync queues another read without clearing them. Synchronization runs about every five minutes while Thunderbird and the Hub are running. Use Change folders to reopen the saved selection and Save import settings to apply changes; this rechecks the selected history range while retaining previously imported mail. You can connect several accounts already managed by Thunderbird. Each has its own folder selection.

Remove automatic setup removes Gravify’s installation instruction. After restarting Thunderbird, you can uninstall the extension in Add-ons and Themes. This does not disconnect imported accounts or delete mail; use Disconnect to stop Gravify imports. Thunderbird may show a managed-settings notice while automatic installation is configured.

If you are using Gravify on another device, carry out installation and mail login on the Hub computer. Thunderbird and the Hub must run under the same operating-system user. No Microsoft developer account, application registration, paid mailbox or copied password/token is needed for this connection. Gravify includes the local bridge runtime.

History imports gradually, one page at a time. During a long initial import, newer mail can wait for the selected history pass to finish. Request sync queues another read; it does not mean the import is complete. Keep Thunderbird open while importing and for subsequent reads. Only selected folders and the chosen time range are imported. Attachments, sending, deletion synchronization and provider-side read receipts are not supported by this connection. Mail moved during a paginated search may need reconnection to rescan its selected folder; do not treat this as a complete mailbox backup.

If discovery fails, open Thunderbird on the Hub computer, check the extension is enabled, and check account permissions in its Options. If an account or folder changed, scan and choose it again. Disconnect stops future imports and retains mail already imported in Gravify. It does not sign you out of Thunderbird or disable the extension for other clients.

Imported email appears in Communications → Email and is available to the configured Gravify assistant through the same retained history. Your chosen AI settings determine where assistant processing occurs; a local mail bridge does not automatically make every AI model local.

To include people you have emailed in the relationship map, select the Sent folder as well as Inbox, and an appropriate history range. A contact can appear even if they have never replied. Outgoing mail counts for its actual To/Cc/Bcc recipients; received mail counts for its author when you are a recipient. Other people copied on a received message do not gain presence just by being copied. Mail contributes using the same session and daily limits as private chat, and only imported history can contribute. Imported coverage remains partial.

An exact email address already associated with a phone contact reuses that person. Similar names can produce duplicate suggestions for your review; a name alone never silently joins people. Confirmed merges combine their email and chat history under one person.

TickTick

Choose Connect beside TickTick. Gravify uses TickTick's official read-only Open API permission and imports selected lists as tasks. Dated tasks appear in Calendar; undated tasks appear in Tasks. Lists without dated tasks are still useful. TickTick currently requires reconnecting if its access token stops working.

Another mail provider

Choose Connect beside Other mail provider and enter the mailbox's IMAP settings. Gravify requires encrypted IMAP over TLS, normally on port 993, and opens folders read-only. Use an app password when your provider requires one; do not enter your normal password if the provider offers app passwords.

The initial folder is INBOX. You may enter additional exact folder names separated by commas. This connection can read and index mail but cannot compose or send it. Provider-specific OAuth is preferable when Google or Microsoft is available.

Synchronize or disconnect

Use Sync now in Mail or Calendar to fetch current changes. Imported data remains local when you disconnect an account; disconnecting removes the saved provider credential and stops future synchronization. Local data deletion is a separate action under Data & Backups.

To decide which calendars appear, choose Choose calendars on a connected account and switch each discovered calendar on or off. Newly discovered calendars are off until you choose them. Use Sync now after the selection has reached your Personal Hub; only selected calendars contribute events to the Calendar view. You can mix calendars from several Google and Microsoft accounts with your TickTick connection. The account name and calendar name help distinguish them.

If the app says Hub setup required, the installed Hub does not contain a usable product provider configuration. Install a build in which that connector is enabled, or ask Gravify support; end users should not create their own Google, Microsoft, or TickTick developer applications.

Provider sign-in returns to Gravify on its reserved local port 28473. If Gravify reports that this port is already in use, close the other local application using it and reopen Gravify. The Hub does not switch OAuth ports silently because Google, Microsoft and TickTick require the callback address to match the public Gravify registration exactly.

Read messages in Communications

Open Communications (the Conversations tab) after synchronization. Gravify groups direct WhatsApp chats and email threads under the same person when their identities are already linked. All shows one chronological local stream; use WhatsApp or Email to inspect only that source. Group chats and email threads with several other people remain separate so Gravify does not invent a one-to-one conversation.

Reading conversations is read-only. Opening a message does not mark it as read at Google, Microsoft, your IMAP provider, or WhatsApp. The source remains visible, and messages and provider credentials stay on your Personal Hub.

Use All calendars to select all discovered calendars, then turn individual ones off if needed. Wait for any pending-selection status to clear. Sync now first sends pending choices to the Hub before requesting new provider data.

Accounts and data sources settings

Read Calendar and recurring activities and Read conversations and email for the next step.

The screenshot shows an example workspace without a connected Hub; connection buttons become available after Hub setup.