Documentation Index
Fetch the complete documentation index at: https://docs.screenpi.pe/llms.txt
Use this file to discover all available pages before exploring further.
screenpipe captures your screen and audio by default. but you can also connect your apps directly — this gives pipes and AI agents richer, structured data from the source.
for the complete registry, auth patterns, multi-account examples, and proxy test calls, use the connection reference. how to connect apps
open screenpipe → click settings (gear icon, bottom of sidebar) → scroll to Data & Privacy → click Connections.
you’ll see all available integrations. click one to configure credentials or start an OAuth flow.
finding API keys & credentials
for integrations that require API keys or other credentials, screenpipe provides help links next to each field:
- look for the ? icon next to the field label (e.g., “API Key”)
- hover over it to see “Learn how to find your API Key for this integration”
- click Open guide → to jump directly to that app’s settings page
this takes you straight to where you need to be — no more hunting through docs.
oauth integrations (Slack, Notion, Gmail, etc.) skip the API key step entirely — just click the big “Connect with [App]” button and approve access in your browser.
some pipes require specific connections. when you install a pipe that needs a connection (like Notion or Toggl), screenpipe will prompt you to configure it automatically.
available integrations
communication
| app | description |
|---|
| Slack | access messages, channels, and threads |
| Discord | access server messages and channels |
| Email | connect your email for context |
| Gmail | OAuth connection to your Google email |
| Telegram | access Telegram messages |
| WhatsApp | access WhatsApp conversations |
| Microsoft Teams | access Teams messages and channels |
| Zoom | access Zoom meeting metadata and cloud recordings |
productivity & project management
| app | description |
|---|
| Notion | read and write to Notion databases and pages |
| Obsidian | sync daily logs, meeting notes, and journals to your vault |
| Google Calendar | enrich meetings with attendees and schedule context |
| Google Docs | read and write Google Docs through OAuth |
| Google Sheets | query spreadsheet metadata and values |
| Linear | access issues and projects |
| Todoist | manage tasks and projects |
| Asana | access tasks and projects |
| Monday.com | access boards and items |
| Trello | access boards and cards |
| ClickUp | access tasks and spaces |
| Jira | access issues and projects |
| Confluence | access pages and spaces |
| Airtable | access bases and records |
| Logseq | sync with your Logseq graph |
CRM & sales
| app | description |
|---|
| HubSpot | sync contacts, deals, and activities |
| Salesforce | access CRM data and records |
| Pipedrive | sync deals and contacts |
| Intercom | access conversations and contacts |
| Zendesk | access tickets and customers |
calendar & scheduling
| app | description |
|---|
| Google Calendar | access your calendar events and schedule |
| Calendly | access scheduling data |
| Cal.com | access scheduling data |
| app | description |
|---|
| GitHub Issues | access issues across repositories |
| Sentry | access error tracking and alerts |
| Vercel | access deployment data |
| Stripe | access payment and subscription data |
| PostHog | access product analytics and event data |
| Supabase | access projects, storage, and edge functions |
| app | description |
|---|
| n8n | trigger n8n workflows from screenpipe |
| Make | trigger Make scenarios from screenpipe |
| Zapier | trigger Zapier automations from screenpipe |
time tracking
| app | description |
|---|
| Toggl | auto-track time based on screen activity |
notifications
| app | description |
|---|
| Pushover | send push notifications |
| ntfy | send notifications via ntfy |
AI & knowledge
| app | description |
|---|
| Perplexity | access AI search results |
| Glean | connect enterprise knowledge |
| Granola | sync meeting notes |
| Limitless | sync Limitless data |
| Fireflies.ai | pull meeting transcripts and action items |
| Otter.ai | connect cloud meeting transcripts |
| Bee | connect Bee wearable captures |
other
| app | description |
|---|
| Brex | access financial data |
| Microsoft 365 | access Office apps data |
| QuickBooks Online | access company accounting data |
multi-account support
you can connect multiple accounts for the same app using instance names. for example, connect both your work and personal Notion:
notion:work — your company workspacenotion:personal — your personal workspace
this is configured in the connections UI when adding a new integration.
use connections from pipes
connections can expose a local proxy endpoint so pipes can call third-party APIs without putting secrets in the prompt:
curl "http://localhost:3030/connections/gmail/proxy/users/me/profile"
curl "http://localhost:3030/connections/hubspot/proxy/crm/v3/objects/contacts?limit=1"
curl "http://localhost:3030/connections/notion/proxy/v1/users/me"
| tool | what it does | setup |
|---|
| Claude Desktop | ask Claude about your screen history | MCP setup → |
| Claude Code | give Claude Code access to your screen context | guide → |
| Cursor | add screen context to Cursor’s AI | MCP setup → |
| ChatGPT | use your ChatGPT subscription in screenpipe chat + pipes | guide → |
| Ollama | use local models for complete privacy | guide → |
you can use both app connections AND AI tool connections at the same time. connect Gmail + Obsidian as data sources, AND connect Claude Desktop to query everything.
why connect apps?
without connections, screenpipe captures what’s visible on your screen. with connections, pipes get structured data directly from the source:
| without connections | with connections |
|---|
| sees email text through accessibility capture when Gmail is open | gets full email threads, senders, timestamps via API |
| sees calendar when you look at it | knows your full schedule, upcoming meetings, attendees |
| sees Notion pages via screen capture | reads and writes to Notion databases directly |
| sees CRM data when you open it | auto-syncs contacts and deals after every call |
troubleshooting
Google OAuth: “app isn’t verified” or “unsafe”
when connecting Gmail, Google Calendar, or Google Docs, you may see a warning that says the app is “unverified” or “unsafe.” this is normal — screenpipe is a local app and Google requires additional verification steps for third-party apps.
how to proceed:
- on the Google warning screen, click Advanced (bottom-left corner)
- click Go to Screenpipe (unsafe) to continue with the connection
- screenpipe will not be marked unsafe once you verify the connection — this is a standard OAuth security flow
if the page closes or doesn’t load, check that:
- you have internet connectivity
- no browser extensions are blocking the OAuth redirect
- your firewall isn’t blocking
localhost:3030 (the local callback endpoint)
connection fails silently
if a connection appears to connect but then disappears:
- check that Pro is active (OAuth requires a Pro subscription)
- verify the app credentials are correct by disconnecting and reconnecting
- check app permissions in the original service (e.g., Notion workspace settings, Slack workspace admin console) — you may need to re-approve access
”not connected” error in pipes
if a pipe reports that a connection isn’t available:
- confirm the connection is active in settings → connections (green dot or “connected” status)
- for multi-account setups, verify the pipe is using the correct instance name (e.g.,
notion:work vs notion:personal)
- try reconnecting: disconnect and reconnect the app
- check the pipe debugging guide for troubleshooting pipe-specific issues
privacy & security
- OAuth connections use standard OAuth flows — screenpipe stores tokens locally in your secure store when available
- CLI-like environments can fall back to local
~/.screenpipe/connections.json
- connected app data stays on your device
- you can disconnect any app at any time in settings → connections
- screenpipe never sends your connected app data to our servers
- OAuth connections require a Pro subscription
questions? join our discord.