FindMe Photo
    New · FindMe MCP

    Install FindMe in your AI assistant

    Upload photos, create events, and check analytics — all by talking to Claude, ChatGPT, Cursor, and more.

    1. Grab your API key

    Opens in a new tab. Keep this page open and come back with your key. Requires Free+, Growth, or Pro.

    2. Pick the tool you use

    Claude Desktop

    Recommended for non-technical users · ~3 minutes · macOS & Windows

    The easy way: let Claude install itself. You paste a prompt; Claude edits its own config file. No terminal, no hidden folders.

    Before you start: install Node.js LTS if you don't have it (simple installer, just click through).

    1. A

      Open Claude Desktop and click the Code tab at the top (not Chat — Code is the one that can edit files on your computer).

      Screenshot

      Claude Desktop window with the Code tab highlighted at the top. Arrow pointing at the Code tab.

    2. B

      Start a new session and choose Local folder (not Cloud). Pick any folder on your Mac — your Desktop is fine.

      This makes Claude run on your machine so it can reach your real config file. Cloud mode is a remote sandbox and won't work.

      Screenshot

      New Code session dialog with Local folder option selected (not Cloud). Arrow pointing at the Local folder button and at Desktop in the folder picker.

    3. C

      Paste this prompt into the chat, replacing the key placeholder:

      Install the FindMe MCP server for me.

- Server name: findme
- Command: npx
- Args: -y findme-mcp
- Env var: FINDME_API_KEY = PASTE_YOUR_KEY_HERE

Edit my claude_desktop_config.json under mcpServers, then tell me to fully quit and reopen Claude.

      Claude will open claude_desktop_config.json, add the findme entry, and ask you to restart.

    4. D

      Fully quit Claude Desktop — not just close the window.

      • macOS: press ⌘ Q, wait 3 seconds, reopen
      • Windows: right-click the Claude icon in the system tray → Quit, then reopen
    5. E

      Open a new chat. Click the wrench/hammer icon near the message box — you should see findme with 12 tools.

      Screenshot

      Claude Desktop chat with the wrench/hammer icon opened, showing 'findme' expanded with its 12 tools listed (create_event, upload_photos_from_paths, etc.).

    6. F

      Try it:

      "Create a FindMe event called 'My First Gallery' for today, then show me the QR code."

      Screenshot

      Claude responding with a created event and a rendered QR code, showing upload/event tool calls in a friendly card.

    Prefer to edit the config file manually? →

    Paste this into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

    {
  "mcpServers": {
    "findme": {
      "command": "npx",
      "args": [
        "-y",
        "findme-mcp"
      ],
      "env": {
        "FINDME_API_KEY": ""
      }
    }
  }
}

    Replace the empty FINDME_API_KEY value with your key, save, fully quit Claude, reopen.

    What your AI can do

    Create, rename, delete events

    create_event · update_event · delete_event · restore_event

    Upload photos from your computer

    upload_photos_from_paths

    Upload photos from URLs

    upload_photos_from_urls

    Import from Google Drive

    upload_photos_from_drive_folder

    Get gallery QR codes

    get_event_qr

    See guest analytics

    get_event_analytics

    Check your usage and storage

    get_usage

    List your events

    list_events · get_event

    Troubleshooting

    I don't see findme in the tool list

    Most common cause: Claude Desktop wasn't fully quit. Closing the window isn't enough — use ⌘Q (Mac) or Quit from the system tray (Windows). Then reopen.

    Claude tried to edit the config but says it couldn't find the file

    You probably started the Code session in Cloud mode. Start a new session and pick Local folder instead — Cloud mode can't reach your real filesystem.

    Claude says 'npx: command not found'

    Node.js isn't installed. Get the LTS installer from nodejs.org, run it, then fully quit and reopen your AI client.

    Claude says the API key is invalid

    Open findme.photo/settings/api, confirm the key isn't revoked. If it is, create a new one and run the install prompt or command again with the new key.

    I can't upload from Desktop/Documents on macOS

    System Settings → Privacy & Security → Full Disk Access → add Claude Desktop (or Terminal if you use the CLI). Quit and reopen.

    Still stuck? Email help@findme.photo with a screenshot of what you see.

    API keys·GitHub ·npm ·MCP Registry