{
  "markdown": "# FindMe Photo MCP Server\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for [FindMe Photo](https://findme.photo) — the AI-powered wedding gallery platform.\n\nDrive your FindMe galleries from Claude, ChatGPT Codex, Cursor, and any other MCP-compatible AI client. Create events, upload photos, pull analytics — all in natural language.\n\n## What it does\n\n> **\"Create a FindMe event for the Sarah & Mike wedding on April 22, upload every photo in `~/Pictures/Sarah-Mike` to it, then show me the QR code.\"**\n\nThe AI uses this MCP server to do all three steps in one turn.\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `create_event` | Create a new gallery. |\n| `list_events` | List your events (paginated). |\n| `get_event` | Get event details + stats. |\n| `update_event` | Rename, re-date, or change access code. |\n| `delete_event` | Soft-delete with 7-day recovery. |\n| `restore_event` | Un-delete within 7 days. |\n| `upload_photos_from_paths` | Upload local files or folders. Primary upload tool. |\n| `upload_photos_from_urls` | Upload from public URLs (Dropbox, direct Drive links, etc.). |\n| `upload_photos_from_drive_folder` | Import from Google Drive (partial in v1). |\n| `get_event_qr` | PNG QR code pointing to the public gallery. |\n| `get_event_analytics` | Guest visits, unique visitors, downloads, selfie searches. |\n| `get_usage` | Current-month API usage, storage, event totals. |\n\n## Requirements\n\n- Node.js 18+\n- A FindMe Photo account on **Free+**, **Growth**, or **Pro**\n- A personal API key from <https://findme.photo/settings/api>\n\n## Install\n\n**The easiest way: let the AI install itself.** Paste a prompt, the AI edits its own config. No hidden files.\n\n> For a step-by-step walkthrough aimed at non-technical photographers, see the [full install guide](https://findme.photo/install).\n\n### Claude Desktop\n\nOpen Claude Desktop, click the **Code** tab (not Chat), then paste this prompt (replace the key):\n\n```\nInstall the FindMe MCP server for me.\n\n- Server name: findme\n- Command: npx\n- Args: -y findme-mcp\n- Env var: FINDME_API_KEY = fm_live_PASTE_YOUR_KEY_HERE\n\nEdit my claude_desktop_config.json under mcpServers, then tell me to fully quit and reopen Claude.\n```\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add findme --scope user --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp\n```\n\n### ChatGPT Codex\n\n```bash\ncodex mcp add findme --env FINDME_API_KEY=fm_live_xxxxx -- npx -y findme-mcp\n```\n\n### Cursor / Windsurf / VS Code / Cline\n\nUse the tool's built-in MCP install UI with:\n- Command: `npx`\n- Args: `-y findme-mcp`\n- Env: `FINDME_API_KEY=fm_live_xxxxx`\n\n### ChatGPT web / mobile\n\n**Coming soon** — requires a hosted MCP endpoint. We're shipping `mcp.findme.photo` next. In the meantime, use Claude Desktop or Codex.\n\n### Any other MCP client\n\n```bash\nFINDME_API_KEY=fm_live_xxxxx npx findme-mcp\n```\n\n## Verify\n\nAfter restart, you should see `findme` in your client's tool list (12 tools). Try:\n\n> Create a FindMe event called \"My First Gallery\" for today, then show me the QR code.\n\n## Troubleshooting\n\n### \"MCP server failed to start\"\n\n- Ensure Node.js 18+: `node --version`\n- First run downloads the package via `npx`; allow it through your firewall\n- Check the JSON is valid if you edited manually (no trailing commas)\n\n### \"Your FindMe API key is invalid or has been revoked\"\n\n- Generate a fresh key at <https://findme.photo/settings/api>\n- Paste the full key including the `fm_live_` prefix\n- Fully quit and restart your AI client\n\n### \"API access requires Free+, Growth, or Pro\"\n\nAPI access is a paid-tier feature. Upgrade at <https://findme.photo/pricing>.\n\n### Upload fails with \"can't find folder\" on macOS\n\nmacOS privacy protection. Open *System Settings → Privacy & Security → Full Disk Access* and add your AI client (Claude Desktop, Terminal, etc.). Then quit and reopen.\n\n### Upload partially failed\n\nThe tool never errors a whole batch for one bad file — it returns a summary showing which files succeeded and which didn't. Ask the AI to retry the failed ones specifically.\n\n## Limits\n\n| Tier | Rate limit | Monthly quota |\n|---|---|---|\n| Free+ | 10 req/min | 500 / month |\n| Growth | 60 req/min | 10,000 / month |\n| Pro | 300 req/min | Unlimited |\n\nPer file: 50 MB photos, 500 MB videos, 50 files per upload batch.\n\n## v1 limitations\n\n- `upload_photos_from_drive_folder` requires an existing Drive import created via the findme.photo web UI; the MCP can poll status but not create imports yet.\n- The MCP runs locally on the same machine as your AI client; it only sees files on that machine.\n\n## Resources\n\n- [FindMe Photo](https://findme.photo)\n- [Install guide](https://findme.photo/install)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n\n## License\n\n[MIT](./LICENSE) — © 2026 FindMe Photo\n",
  "bytes": 4778,
  "sha": "1e3c9674ff27e99124b1108eded97122d20c6478e32f2918084affbbd36155fd",
  "repo_slug": "findmephoto/findme-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_findmephoto_findme_mcp_22985fc6/readme"
}