Skip to main content
connections give pipes and AI agents structured context from the source system, beyond what screenpipe can infer from visible app text. screenpipe privacy settings

​
finding credentials

when setting up connections that require API keys, credentials, or URLs, screenpipe provides direct help links in the settings UI:
  • look for the ? icon next to each field (API Key, Webhook URL, etc.)
  • hover or click to see “Learn how to find your X for this integration”
  • select Open guide → to jump to that service’s settings or API docs page
  • no more hunting through documentation
this works for all API key, webhook, and custom credential fields.

​
auth patterns

patternexamplesnotes
OAuthGmail, Google Calendar, Google Docs, Notion, Jira, Microsoft 365, Teams, Vercel, Supabase, Zoombest user experience; tokens are stored locally; no API key needed
API keyLinear, HubSpot, PostHog, Sentry, Stripe, Toggl, Pipedrive, Gleansimple and reliable; help links guide you to API settings pages; rotate keys if a device is lost
webhook URLn8n, Make, Zapier, Pushover, ntfy, Resendbest for one-way notifications or workflow triggers
local pathObsidian, Logseqkeeps notes local
custom/private CABeescreenpipe includes the required trust configuration for the provider

​
credential storage

screenpipe stores connection credentials in the local secure store when available. environments without the secure store can fall back to ~/.screenpipe/connections.json. pipe prompts should not contain secrets. prefer connected app proxies: 
curl "http://localhost:3030/connections/<id>/proxy/<provider-path>"
screenpipe injects the credential on the local side, so the AI sees the request shape but not the secret value.

​
available integrations

The app registry currently includes these connection IDs:
categoryintegrations
communicationSlack, Discord, Email (SMTP), Gmail, Telegram, WhatsApp, Microsoft Teams, Zoom
productivityNotion, Obsidian, Google Calendar, Google Docs, Google Sheets, Microsoft 365, Logseq, Workflowy, Airtable, Confluence, Odoo
project managementLinear, Jira, Asana, Monday.com, Trello, ClickUp, Todoist, Cal.com, Calendly
CRM and supportHubSpot, Salesforce, Pipedrive, Intercom, Zendesk, Bitrix24
developer and opsGitHub, Sentry, Vercel, Supabase, PostHog
financeStripe, Brex, QuickBooks Online, Financial Sense
meeting and voiceGranola, Fireflies.ai, Otter.ai, Limitless, Bee, Pocket, Lexi AI
automation and notificationsn8n, Make, Zapier, Pushover, ntfy, Loops, Resend
AI and knowledgePerplexity, Glean, Readwise
AI assistant memoryClaude Code, Codex CLI
AI agent gatewayOpenClaw

​
multi-account support

use named instances when you have more than one account for the same service:
exampleuse
notion:work and notion:personalseparate work and personal workspaces
gmail:founder and gmail:supportseparate inboxes
hubspot:prod and hubspot:sandboxseparate CRM portals
posthog:screenpipe and posthog:benchseparate analytics projects

​
test queries

after connecting, run a tiny request before relying on a pipe: 
curl "http://localhost:3030/connections/gmail/proxy/users/me/profile"
curl "http://localhost:3030/connections/google-calendar/proxy/users/me/calendarList"
curl "http://localhost:3030/connections/notion/proxy/v1/users/me"
curl "http://localhost:3030/connections/hubspot/proxy/crm/v3/objects/contacts?limit=1"
curl "http://localhost:3030/connections/linear/proxy/graphql"
curl "http://localhost:3030/connections/readwise/proxy/api/v2/auth/"
exact provider paths follow the provider API. if a request fails, reconnect the integration first, then check the provider’s own permissions.

​
OAuth callback troubleshooting

OAuth redirects back to: 
http://localhost:3030/connections/oauth/callback
if OAuth fails:
  1. keep screenpipe open during the login flow.
  2. check curl http://localhost:3030/health.
  3. make sure the browser did not block the redirect.
  4. reconnect from settings -> connections.
  5. check whether the provider account type is supported. Microsoft Teams, for example, needs a work or school account.

​
choosing the right connection

needconnect
better speaker namesGoogle Calendar
CRM follow-up after callsHubSpot, Salesforce, Pipedrive, Notion
daily notes and highlightsObsidian, Logseq, Google Docs, Readwise
product analytics contextPostHog, Sentry, GitHub, Vercel
finance or billing workflowsStripe, Brex, QuickBooks
meeting importZoom, Fireflies.ai, Granola, Otter.ai
notificationsSlack, Pushover, ntfy, Resend