Connect CloudSpot to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Galleries, clients, documents and photography studio workflows.

CloudSpot MCP server through Cotlet.dev

Connect CloudSpot to ChatGPT, Claude, Codex and Claude Code through Cotlet.dev. Manage galleries, clients, projects and documents in your own signed-in CloudSpot account.

This is an unofficial integration, not affiliated with CloudSpot. Cotlet.dev hosts the connection through your Cloud Browser. This repository provides an optional Python stdio MCP bridge.

Connect your account

  1. Request access to CloudSpot.
  2. Open https://app.cloudspot.io/login in your Cotlet.dev Cloud Browser, sign in yourself and enable CloudSpot for agents.
  3. Connect your agent. Refresh the connector if you enabled CloudSpot after connecting.

ChatGPT

Open Settings > Apps & Connectors > Create. Enter https://cotlet.dev/mcp/v1/connect as the MCP server URL and choose OAuth.

Claude

Open Settings > Connectors > Add custom connector and enter https://cotlet.dev/mcp/v1/connect.

Codex

Create a Cotlet.dev API key in your console and set COTLET_API_KEY in your environment. Add:

[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

Claude Code

claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"

Photography studio workflows

Examples based on the live CloudSpot integration reference:

  • Read galleries and see the favorites and downloads in Collection Analytics.
  • Create a Collection and deliver a Gallery with an optional Zip download.
  • Turn an inquiry into a Project and prepare contracts and questionnaires.
  • Draft an invoice and payment schedule, then approve sending it.
  • Set up mini-sessions and reschedule bookings.
  • Review pending print orders before sending them to the lab.

The live reference lists 17 capabilities: 2 read and 15 write. The hosted groups are cloudspot_read and cloudspot_write.

  • read_galleries
  • view_collection_analytics
  • create_collection
  • deliver_images
  • set_gallery_expiration
  • manage_leads
  • manage_clients
  • manage_projects
  • manage_to_dos
  • manage_contracts
  • manage_questionnaires
  • manage_invoices
  • record_manual_payment
  • manage_mini_sessions
  • manage_bookings
  • manage_discount_codes
  • review_pending_orders

read_galleries and view_collection_analytics only read. Other workflows can include read actions such as list and get; writes ask for confirmation by default, configurable per tool. Review recipients, amounts and order details before approving. Features depend on your CloudSpot plan: Studio workflows require Full Suite features. Uploading photos and crop edits remain with you. CloudSpot does not email clients when a booking moves; arrange a separate message. Submitted print orders cannot be undone through the tools.

Optional local stdio bridge

Python 3.10 or newer is required, with no runtime dependencies. Clone this repository and configure a client that supports stdio:

{"mcpServers":{"cloudspot":{"command":"python3","args":["/absolute/path/to/cloudspot-mcp/cloudspot_agent.py"],"env":{"COTLET_API_KEY":"your-cotlet-key"}}}}

The local bridge lists seven browser helpers: cloudspot_guide, cloudspot_status, cloudspot_open, cloudspot_read, cloudspot_click, cloudspot_type and cloudspot_close. They forward to Cotlet.dev's shared browser tools and are distinct from the 17 hosted workflow capabilities. Call the guide first and close the browser when finished. Discovery works without a key; executing a tool requires your Cotlet.dev key and connected account.

python3 cloudspot_agent.py connect
python3 cloudspot_agent.py guide
python3 cloudspot_agent.py status
python3 cloudspot_agent.py serve

You can also build the included Dockerfile and pass COTLET_API_KEY as an environment variable.

Reference and access

Licensed under Elastic License 2.0. See LICENSE.

MCP Server · Populars

MCP Server · New

    frontman-ai

    frontman

    The AI agent that lives in your framework/browser

    Community frontman-ai
    Laksh-star

    Screenward

    Movie and TV discovery, watch planning, and streaming availability—for browsers and MCP clients.

    Community Laksh-star
    codescene-oss

    CodeHealth MCP Server

    The CodeScene MCP Server exposes CodeScene’s Code Health analysis as local AI-friendly tools.

    Community codescene-oss
    Fan-Pier-Labs

    OpenRecord

    Let Claude read and manage your Epic MyChart health records — labs, meds, messages, refills, imaging. Claude Desktop extension (MCP server), iOS app, and CLI. Runs on your device.

    Community Fan-Pier-Labs
    video-db

    skills

    Server-side video workflows for agents: ingest, understand, search, edit, stream.

    Community video-db