screenpipe × Claude
Start on your computer · phone access is optional
Set up screenpipe for Claude.
Check your screenpipe connection, then ask Claude about your work. Start on your computer. Phone access is optional; it requires Screenpipe Business or higher and cloud-synced data.
Before you start on your computer
New to screenpipe? Follow the screenpipe installation and first-run guide, then return here. Already recording? Go straight to the connection check.
- screenpipe and the official Claude desktop app on the same computer.
- A Claude account. No Screenpipe Business upgrade is needed for this first, same-computer setup.
Start here
Use your work context on your computer.
First, get one useful answer from the work screenpipe recorded. You do not need phone access or Business sync to complete this part.
Computer setup, part 1Check the connection
Check Claude in screenpipe.
This connects Claude to screenpipe on the same computer. It is not a prerequisite for the separate synced-data route below.
Install and open Claude
Install the official Claude desktop app, open it once, and sign in.
Look for the check mark
Open or restart screenpipe. Open Settings → Connections and look for a check mark next to Claude. In versions with an AI apps group, open Manage first.
If Claude has a check mark, leave the connection as it is. Do not disconnect it or add another connection.
If the check mark is missing, restart both apps and check again. If it is still missing, contact support before changing the connection settings.
Check: The check mark confirms configuration. Use the search test below to check that your AI can retrieve context.
Start a new chat
Completely quit and reopen Claude. Start a new chat and keep screenpipe running.
Try the first question below. Review any request to search and allow it if you agree.
Sources and technical details
Finish your computer setup
Ask your first question.
Make a test note
With screenpipe recording, type screenpipe setup check in a notes app and leave it visible for a moment. You can reuse your setup note. Keep private or confidential information out of the test.
Find the note in screenpipe’s Timeline before asking your AI. If it is missing, check the recording setup first.
Try this in Claude
Use screenpipe to find my ‘screenpipe setup check’ note. Show what it says and when it was recorded. If you cannot find it, tell me.
What to confirm
- Your note appears in screenpipe’s Timeline.
- Claude finds it and shows when it was recorded.
- You have reviewed what screenpipe records and what you allow Claude to access.
- Desktop setup is complete. Mobile use is optional, but requires Screenpipe Business or higher and cloud-synced data.
Once this works, you’re ready to use screenpipe on your computer. Phone access below is optional. You can stop here.
Optional next step · Use your context on your phone
Take your work context with you.
Ask Claude about work you’ve synced to your Screenpipe account. Your phone reads uploaded context, not your computer directly.
You can skip the local AI connection above if you only want mobile access. You still need screenpipe to record work on a computer and upload it with Data Sync.
Required for phone access: Screenpipe Business or higher + cloud Data Sync
Start with Business or higher.
With Screenpipe Business or higher, sync context from the computers you choose so a supported, connected AI can use it when you are away from your desk.
You do not need Data Sync or a Business upgrade for the same-computer connection. To use screenpipe context on your phone, Screenpipe Business or higher and cloud-synced data are required.
Screenpipe does not support a direct mobile connection to an online computer. Your AI app also needs a supported account and working connection; the plan and sync requirements alone do not verify that setup.
Turn on Data Sync
Bring together context from your computers.
You can skip the desktop AI connection above for this route. Mobile requests can use only cloud-synced data, not a direct connection to your computer. You still need screenpipe to record and upload the context first.
Check your Screenpipe plan
Mobile access requires Screenpipe Business or higher. Confirm the intended Screenpipe account and plan before enabling sync.
Your Claude account and its connection permissions are separate requirements. A Claude subscription does not replace the required Screenpipe plan.
Choose which computer to sync
If screenpipe is not installed yet, install it on the computer that will record your work and enable the required recording permissions. You do not need to set up the local Claude connection first.
In screenpipe, open Settings → Account → Data Sync. Confirm the intended account.
Sync uploads searchable screen text, audio transcripts, and related context, not just one answer. If you want to share this data, enable Data Sync and set a recognizable Device name.
Repeat on each computer you want included. Turning on Allow data sync on the website alone does not connect a computer.
Wait for your first upload
Create a test note titled screenpipe setup check (or add a new line if you already made it) after enabling sync. Leave it visible for a moment while recording runs. Older history is not automatically uploaded. Keep screenpipe recording and the computer online. Do not include private or confidential information.
Wait about five minutes, then close and reopen Account to refresh Synced devices. Check your Device name and last synced time.
Check: Your computer shows a recent successful sync.
Copy your connection link
On the Screenpipe website, sign in to the same account. In data sync, confirm Allow data sync is on.
Under Use data in your AI, select copy URL. You will paste it into your AI’s settings next. If access is unavailable, resolve that before continuing.
https://screenpipe.com/api/user/data-sync/mcp
Sources and technical details
Connect synced context to Claude
Let Claude use the context you have synced.
Do this in your browser. You do not need to install Claude Desktop or complete the local connection first.
Add screenpipe in Claude
On the Claude website, open Customize → Connectors → + → Add custom connector. Name it screenpipe, paste your connection link, and choose Add. Leave optional advanced fields unchanged.
For Team or Enterprise, an owner adds it first under Organization settings → Connectors → Add → Custom → Web. Users then connect their own Screenpipe accounts.
https://screenpipe.com/api/user/data-sync/mcpSign in and allow access
Select Connect. In the window that opens, sign in to the Screenpipe account you used for sync.
Review the requested access. If you agree, approve it and return to Claude. If sign-in fails, stop and contact support.
Try a new chat on the website
Start a new chat. Choose + → Connectors and turn on screenpipe.
Ask for the new note you made after enabling sync, with its computer and recorded time.
Check: Claude finds the synced note. The website connection works independently of the local desktop setup.
Sources and technical details
Use synced context on your phone
Ask about synced work from the Claude app.
Your phone requests cloud-synced data from your Screenpipe Business or higher account. It does not connect directly to an online computer. New work must be recorded and uploaded before it can be found.
Use the same Claude account
Update the official Claude phone app and sign in to the same Claude account and organization as the website connection.
Choose screenpipe and ask
In a new chat, open + → Connectors and turn on screenpipe. Ask for your synced test note and its recorded time.
Check that Claude performs a fresh search. An old conversation appearing on your phone does not prove the connection works.
Check: A new chat in the native Claude app finds your synced note.
Sources and technical details
If something doesn’t work
Do I need Business to use screenpipe with Claude?
Not for Claude on the same computer. Mobile access requires Screenpipe Business or higher and cloud-synced data; Screenpipe does not support a direct mobile connection to an online computer. Your Claude account and connection permissions are separate requirements. Check the supported connection before upgrading specifically for phone use.
Data Sync does not appear in screenpipe settings
Check Settings > Account in the current desktop app and confirm your Screenpipe account. Mobile use requires Screenpipe Business or higher and cloud-synced data; do not assume trial or existing-license sync access confirms mobile eligibility. Contact support@screenpi.pe if access is missing. The local Claude Desktop path can still work without sync.
Claude works on the computer but not on my phone
The local desktop connection does not connect your phone. Confirm Screenpipe Business or higher and a successful cloud sync, then test the separate website connection. Use the same Claude account and organization on your phone and choose + → Connectors → screenpipe. If a fresh search fails, contact support; do not use a direct connection to an online computer as a workaround.
A note is visible locally but missing from synced context
Create a new note after enabling Data Sync; older history is not automatically uploaded. Keep screenpipe recording and the computer online. After about five minutes, close and reopen Account to refresh Synced devices and last synced. Check you used the same Screenpipe account on the computer and website.
Claude Desktop does not show screenpipe
Open screenpipe Settings → Connections and look for a check mark next to Claude. Leave an existing connection as it is. If the check mark is missing after restarting both apps, contact support before changing the settings. A check mark confirms configuration; the search test checks that Claude can retrieve context.
Does the local connection also cover claude.ai or mobile?
No. It configures the same-computer connection only. Website and phone chats use a separate account connection to synced context. Mobile access requires Screenpipe Business or higher and cloud-synced data; keeping your computer online is not a substitute for sync.
Do I need Claude Desktop before setting up synced context?
No. The Claude desktop connection is an optional same-computer route. For synced context, start with screenpipe recording and Data Sync, then add your connection on the Claude website. You do not need to complete the local Claude steps first.
Can I connect just by typing a prompt?
Once screenpipe tools are available, normal prompts can ask Claude to retrieve context. A prompt alone does not install a missing integration or approve access. Naming screenpipe helps Claude choose the right tool.
A search returns no useful result
Check that screenpipe was recording during the requested time, then narrow the request by app, phrase, or time range. MCP can only retrieve context that was captured and indexed.
Sources & further reading
- Claude: connecting tools and using them on mobile(opens in a new tab)
- Screenpipe quickstart and agent setup(opens in a new tab)
- Claude Code guide(opens in a new tab)
- Privacy and data flow(opens in a new tab)
- Automatic setup in the released 2.7.27 app (source)(opens in a new tab)
Local setup reviewed against screenpipe 2.7.27 and official Claude documentation. Screenpipe’s product review confirms Business or higher and cloud-synced data for mobile use. The synced Claude connection still needs end-to-end testing.