Troubleshooting Common Issues

Solutions for common issues with permissions, audio capture, sync, CRM connections, and more.

Audio & Meeting Capture

Nutan isn't capturing meeting audio

  1. Check Accessibility permission — Go to System Settings → Privacy & Security → Accessibility and verify Nutan is enabled. If it's listed but greyed out, remove it and re-add it.
  2. Restart the app — After granting permissions, quit Nutan completely (Cmd + Q) and relaunch. Permission changes require a restart.
  3. Check your audio output — Nutan captures system audio from your current output device. If you switch headphones mid-meeting, capture may pause. Stay on the same device throughout the call.

Transcription is slow or inaccurate

  • First-time model download — The transcription model downloads on first use. Until it's fully downloaded, transcription won't work. Check your internet connection and wait for the download to complete.
  • CPU load — If your Mac is under heavy load, transcription may lag. Close unnecessary apps during important calls.
  • Older Mac — Newer Macs run on-device AI faster. If you're on an older model, expect transcription to be slower but still accurate.

Push-to-talk isn't working

Verify that Nutan has Microphone permission in System Settings → Privacy & Security → Microphone. Push-to-talk uses the microphone, which is separate from system audio capture.

CRM & Integrations

CRM connection failed

  • Correct account — Make sure you're signing into the CRM account that has access to deals and contacts. If your company uses SSO for Salesforce, use your SSO credentials.
  • Permissions — Your CRM user account needs read access to deals and contacts. Check with your Salesforce or HubSpot admin.
  • Try again — Go to Settings → Integrations, disconnect, then reconnect. This issues fresh OAuth tokens.

CRM data not appearing

  • Wait for initial sync — After connecting, the first sync may take a few minutes depending on how many deals and contacts you have.
  • Check CRM permissions — Nutan can only see data your CRM user has access to. If deals are restricted by role or territory, Nutan won't see them.

Token refresh failed / "Please reconnect"

OAuth tokens expire periodically. Nutan refreshes them automatically, but if refresh fails (network issues, password change, admin revoked access), you'll see a reconnect prompt.

  1. Go to Settings → Integrations.
  2. Click Disconnect next to the affected service.
  3. Click Connect to re-authorize.

This is expected behavior after password changes or if your admin rotates API credentials.

Gmail or Calendar not connecting

  • Google Workspace restrictions — Some Google Workspace admins restrict which third-party apps can access Gmail and Calendar. Ask your IT admin to whitelist Nutan.
  • Correct account — If you have multiple Google accounts, make sure you're authorizing with your work account.

Cloud Sync

Sync isn't working

  • Check sync is enabled — Go to Settings and verify cloud sync is toggled on.
  • Internet connection — Cloud sync requires an active internet connection. Nutan syncs every 5 minutes when connected.
  • Sync limits — Each sync batch handles up to 500 rows. If you have a large backlog (first sync after enabling), it may take several cycles to catch up.

Data not appearing on another device

  • Both devices must have cloud sync enabled and be signed into the same account. Sync runs on a 5-minute interval, so new data may take up to 10 minutes to appear on the other device.

Sign-In & Account

Can't sign in

  • Browser required — Nutan opens your system browser for authentication. If no browser opens, check that you have a default browser set in System Settings → Desktop & Dock → Default web browser.
  • Popup blocker — Some browser extensions block popups. If the auth window doesn't open, try disabling popup blockers temporarily.
  • Firewall — If you're on a corporate network, the firewall may block the authentication callback URL. Contact your IT team to whitelist nutan.ai.

Signed out unexpectedly

This usually means your refresh token expired or was revoked. Sign in again — your local data is preserved.

Performance

App is slow or unresponsive

  • Check Activity Monitor — If Nutan is using high CPU, it may be downloading or indexing AI models. This is a one-time operation.
  • Large knowledge base — Uploading many large files (especially PowerPoint) may temporarily increase memory usage during indexing. Wait for indexing to complete.
  • Restart — Quit and relaunch. This clears any temporary memory buildup.

Database is large

Over time, your local database may grow if you have many meetings and deals. This is normal. The database is compacted automatically. If it exceeds several GB, consider archiving old data or disabling cloud sync for historical items.

Still Need Help?

Use the chat widget on the support page at nutan.ai/support to ask questions. Our AI assistant can search across all help articles and guide you to the right solution.

Related articles