← AI assistants

OwAI guides · English

Connect ChatGPT to your photo library with OwAI MCP

Set up OwAI in ChatGPT, authorize your account, search photos and videos, and manage collections. Includes pricing, permissions and connection troubleshooting.

By · Updated:

Read as Markdown

Before you connect

Use ChatGPT in your browser for setup. You need access to custom MCP connections under your account or workspace policy. The steps below follow the current Plugins interface; older interfaces may call these Apps or Connectors. Developer mode is a testing connection, not evidence that OwAI has been approved for the public directory.

Install OwAI, add a folder, finish indexing, sign in to an OwAI account with permanent Cloud Access, and enable Cloud index sync. Wait for the initial sync to finish. Free local desktop use does not include MCP. Hosted semantic searches use prepaid search credits; listing folders and exact metadata-only searches do not run inference.

Add OwAI in ChatGPT

MCP server URL: https://index.organizewith.ai/mcp

Use this public endpoint without a personal device ID or access token in the URL. Your OAuth login selects your private account; you do not need to paste a developer key into the chat.

  1. In ChatGPT, open Settings → Security and login and turn on Developer mode if it is available. If your workspace does not allow it, ask the administrator about custom MCP access.
  2. Open Plugins from the sidebar and use the plus button to add a custom connection. Enter Organize with AI as its name and a description such as Search and organize my OwAI photo and video library.
  3. Under Connection, choose a remote/server URL connection and enter https://index.organizewith.ai/mcp. Choose OAuth if an authentication selector is shown; leave optional client credentials empty unless your administrator supplied them.
  4. Create the connection, sign in to your OwAI account in the browser, and review the requested permissions before approving. Return to ChatGPT and confirm the connection has loaded its tools. Reaching the OwAI home page alone does not mean linking completed.

Verify the connection with a read-only request

Open the OwAI plugin and select Try in chat, or start a new conversation and enable OwAI from its tools menu. Ask: List the folders in my OwAI library. Do not change anything. A working connection should call an OwAI inspection tool and return your synced folder names — not generic instructions or a claim that it cannot access a library.

Next ask: Show five photos from Camera Roll, with filenames and captured dates. Replace Camera Roll with a folder from the first result. This metadata-only test verifies the account and synced index without spending semantic-search credits. If it works, try: Find five beach photos in Camera Roll from June through August 2026. Use dates that exist in your own library.

ChatGPT chooses tools from the live connection. Do not invent a local/remote tool prefix or assume a previous conversation's IDs still identify the intended files.

Tool: search_media
{
  "source_name": "Camera Roll",
  "media_type": "image",
  "limit": 5
}

Create a collection and verify completion

After reviewing the search results, ask ChatGPT to create a collection in that same folder and add the selected photos. This requires the appropriate OAuth write permission. Allowing a tool in ChatGPT does not expand an existing read-only OAuth grant; reconnect with the needed permission when required.

Keep the owning OwAI desktop app running with cloud sync enabled. Remote changes are queued for that device and applied using the desktop app's library logic. ChatGPT should check get_library_command until it succeeds or fails, then inspect the resulting collection and its membership. Queued or pending does not mean created.

Review duplicate candidates before any deletion. Ask for preview_media_deletion first, review its exact files, favorites and source-specific retention warning, then explicitly approve that plan before apply_media_deletion. Local-folder files use OwAI’s 30-day recovery; Apple Photos uses Recently Deleted, and OneDrive uses Microsoft’s recycle bin. A similarity score alone is not approval; see the recovery workflow below before deleting anything.

What ChatGPT can see — and what it cannot open

This connection searches your synced index. It does not install a local connector or give ChatGPT browser access to your laptop's filesystem. Using ChatGPT in a browser on the same laptop does not make a returned local path readable by the cloud assistant.

The synced index contains metadata and embeddings, not your original photos or videos. To read a local-folder image or video, update OwAI to a build with Remote media access, enable that option in Settings → AI assistants on the owning device, and keep the app online. ChatGPT can then call read_media; no device-specific URL is needed. The option is off by default, and older desktop builds cannot serve media reads. Refresh the connector if the tool is missing.

For OneDrive assets, read_media fetches original images or authenticated video streams through the connected Microsoft account without an online desktop or desktop relay. OneDrive library edits also execute on the server. See the OneDrive guide for setup, caching, cloud processing and Microsoft recycle-bin behavior.

Apple Photos uses the owning Mac instead: remote image reads require OwAI online, full Photos access and Remote media access enabled. PhotoKit provides the full current rendered image; Photos mutations also need the owning Mac. Editable user albums link to OwAI collections, favorites synchronize both ways, and groups publish their computed image membership as native albums. Group rules remain in OwAI. Read the Apple Photos guide before changing a linked collection or group.

read_media preserves full images when they fit its 5 MiB inline budget and adapts larger or incompatible images only as needed, never substituting gallery thumbnails. Photos JPEG renditions are adapted_image; videos return video_stream links by default; rendition=still explicitly requests a video_still thumbnail. Playback requires client support for authenticated resource fetching and the source codec. Local-folder and Photos reads relay bytes transiently without opening a window or storing media in the index. ChatGPT receives the image under its own data policy. An offline or disabled owner produces an unavailable response, not an image.

Read-only remote inspection can use the last synced index while OwAI is closed. Local-folder and Apple Photos indexing, file actions and queued library changes need the owning app online. Fully cloud-based OneDrive indexing and supported OneDrive edits do not. Connecting OwAI shares requested tool results with ChatGPT under the services' respective data policies.

If ChatGPT cannot connect or returns no results

  • No Developer mode or add button: check account availability and workspace policy. This is not fixed by changing the MCP URL to localhost.
  • Sign-in completed but the connection failed: return to the connection details, check its status, and retry account linking. An invalid_scope response is an OAuth permission problem; share the error with support, not the full callback URL or token.
  • Empty library: confirm the same OwAI account is used in ChatGPT and on desktop, and check that Cloud index sync has finished.
  • Folder listing works but visual search fails: check search credits and the reported hosted-inference error. First try a query without a visual concept to separate index access from inference.
  • Tool missing or an old schema after an update: open the developer connection under Plugins, select Refresh when available, and start a new chat with OwAI enabled.
  • A change stays pending: check the owning app is online with cloud sync enabled. Keep the original command ID; do not repeatedly create the same collection.