← AI assistants in OwAI

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.

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. Do not authorize permanent file deletion based only on a similarity score. ChatGPT must obtain confirmation for the specific destructive action.

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. For an inline photo or video-still preview, 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 previews. Refresh the connector if the tool is missing.

read_media relays the requested preview without opening a window on your laptop. A video preview is a still image, not movie playback. The relay handles bytes transiently rather than storing them in the index; ChatGPT receives the preview under its own data policy. Turning Remote media access off stops access. 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. New indexing, local file actions and queued library changes need the owning app online. 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.
Connect ChatGPT to your photo library with OwAI MCP | OwAI