Unsplash MCP server Let your AI agent find and sort your Unsplash photos.

ToolWhat it doesAccess

• search_photos Search Unsplash photos by keyword. read

  Returns the photos of one results page with the ID, description, size, photographer and a link to the photo page. Order follows the sort you pass, relevance by default. The next_cursor field is empty on the last page. Your account does not need any special role.

  MCP callunsplash_read → search_photos

  REST endpointGET https://cotlet.dev/api/v1/unsplash/photos/search

  Parameters

  Parameters: search_photos

  Name	Type	Description
  query string required	string	Search words, as typed in the Unsplash search box.
  order_by string	string	Sort order: relevant or latest.
  orientation string	string	Photo orientation, as in the search filters.
  color string	string	Dominant color, as in the search filters.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "photos": [
      {
        "photo_id": "Hy4kT9xQe2A",
        "description": "Laptop on a wooden desk by a window",
        "width": 6000,
        "height": 4000,
        "photographer": "Maria Costa",
        "photographer_url": "https://unsplash.com/@mariacosta",
        "url": "https://unsplash.com/photos/Hy4kT9xQe2A"
      },
      {
        "photo_id": "Qm7bLw3Rn5c",
        "description": "Home office with a plant and a notebook",
        "width": 5400,
        "height": 3600,
        "photographer": "Tom Becker",
        "photographer_url": "https://unsplash.com/@tombecker",
        "url": "https://unsplash.com/photos/Qm7bLw3Rn5c"
      }
    ],
    "next_cursor": "eyJwYWdlIjoyfQ"
  }

• get_photo Read one photo with its photographer, size and links. read

  Returns the description, size, photographer with the profile link, the photo page link and the image links shown on the page. Use it before you put a photo in a post, so the credit line is right. It does not download the file.

  MCP callunsplash_read → get_photo

  REST endpointGET https://cotlet.dev/api/v1/unsplash/photos/{photo_id}

  Parameters

  Parameters: get_photo

  Name	Type	Description
  photo_id string required	string	Photo ID from search_photos, get_photo or list_collection_photos.

  Example input

  {
    "photo_id": "photo_8c41d2"
  }

  Example response

  {
    "photo_id": "Hy4kT9xQe2A",
    "description": "Laptop on a wooden desk by a window",
    "width": 6000,
    "height": 4000,
    "photographer": "Maria Costa",
    "photographer_url": "https://unsplash.com/@mariacosta",
    "url": "https://unsplash.com/photos/Hy4kT9xQe2A",
    "image_url": "https://images.unsplash.com/photo-hy4kt9xqe2a?w=1080"
  }

ToolWhat it doesAccess

• search_collections Search public Unsplash collections by keyword. read

  Returns collections with the ID, title, owner and photo count, in the order the Unsplash search gives them. Private collections of other people are not listed. Open one with list_collection_photos.

  MCP callunsplash_read → search_collections

  REST endpointGET https://cotlet.dev/api/v1/unsplash/collections/search

  Parameters

  Parameters: search_collections

  Name	Type	Description
  query string required	string	Search words.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "collections": [
      {
        "collection_id": "8841203",
        "title": "Remote work",
        "owner": "Maria Costa",
        "total_photos": 62,
        "url": "https://unsplash.com/collections/8841203/remote-work"
      },
      {
        "collection_id": "5527710",
        "title": "Home office",
        "owner": "Tom Becker",
        "total_photos": 38,
        "url": "https://unsplash.com/collections/5527710/home-office"
      }
    ],
    "next_cursor": ""
  }

• list_collection_photos List the photos inside one collection. read

  Returns the photos of a collection in the order Unsplash shows them, with ID, description, photographer and photo link. It works for public collections and for private ones that your account owns. Any other private collection returns APP_NOT_FOUND.

  MCP callunsplash_read → list_collection_photos

  REST endpointGET https://cotlet.dev/api/v1/unsplash/collection-photos

  Parameters

  Parameters: list_collection_photos

  Name	Type	Description
  collection_id string required	string	Collection ID from search_collections or list_my_collections.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "collection_id": "collection_8c41d2"
  }

  Example response

  {
    "collection_id": "8841203",
    "title": "Remote work",
    "photos": [
      {
        "photo_id": "Hy4kT9xQe2A",
        "description": "Laptop on a wooden desk by a window",
        "photographer": "Maria Costa",
        "url": "https://unsplash.com/photos/Hy4kT9xQe2A"
      },
      {
        "photo_id": "Qm7bLw3Rn5c",
        "description": "Home office with a plant and a notebook",
        "photographer": "Tom Becker",
        "url": "https://unsplash.com/photos/Qm7bLw3Rn5c"
      }
    ],
    "next_cursor": ""
  }

• list_my_collections List the collections of the signed-in account, public and private. read

  Returns each collection with ID, title, visibility and photo count, as on the Collections tab of your profile. Use the IDs with list_collection_photos, add_photo_to_collection and remove_photo_from_collection.

  MCP callunsplash_read → list_my_collections

  REST endpointGET https://cotlet.dev/api/v1/unsplash/my-collections

  Parameters

  Parameters: list_my_collections

  Name	Type	Description
  cursor string	string	Next page cursor from the previous call.

  Example response

  {
    "collections": [
      {
        "collection_id": "9034471",
        "title": "Blog hero images",
        "visibility": "public",
        "total_photos": 24
      },
      {
        "collection_id": "9034502",
        "title": "Spring launch",
        "visibility": "private",
        "total_photos": 9
      },
      {
        "collection_id": "9034518",
        "title": "Newsletter covers",
        "visibility": "private",
        "total_photos": 41
      }
    ],
    "next_cursor": ""
  }

ToolWhat it doesAccess

• search_users Search Unsplash members and photographers by name or username. read

  Returns the username, display name, photo count and profile link of each match, in the order the Unsplash search gives them. Pass a username to get_user or list_user_photos.

  MCP callunsplash_read → search_users

  REST endpointGET https://cotlet.dev/api/v1/unsplash/users/search

  Parameters

  Parameters: search_users

  Name	Type	Description
  query string required	string	Name or username.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "query": "query"
  }

  Example response

  {
    "users": [
      {
        "username": "maya_lin",
        "name": "Maya Lin",
        "total_photos": 134,
        "url": "https://unsplash.com/@maya_lin"
      }
    ],
    "next_cursor": ""
  }

• get_user Read the public profile of one Unsplash member. read

  Returns the display name, bio, location, photo count, collection count and profile link as shown on the public profile. Only public information comes back.

  MCP callunsplash_read → get_user

  REST endpointGET https://cotlet.dev/api/v1/unsplash/user

  Parameters

  Parameters: get_user

  Name	Type	Description
  username string required	string	Username from search_users, without the @.

  Example input

  {
    "username": "username"
  }

  Example response

  {
    "username": "maya_lin",
    "name": "Maya Lin",
    "bio": "Food and kitchen photography.",
    "location": "Lisbon, Portugal",
    "total_photos": 134,
    "total_collections": 6,
    "url": "https://unsplash.com/@maya_lin"
  }

• list_user_photos List the photos of one Unsplash member. read

  Returns the member's public photos, newest first as on the Photos tab of the profile, with ID, description and photo link. Use get_photo for the full details of one.

  MCP callunsplash_read → list_user_photos

  REST endpointGET https://cotlet.dev/api/v1/unsplash/user-photos

  Parameters

  Parameters: list_user_photos

  Name	Type	Description
  username string required	string	Username from search_users, without the @.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "username": "username"
  }

  Example response

  {
    "photos": [
      {
        "photo_id": "Zr2nVd8Ks4f",
        "description": "Sliced lemons on a marble counter",
        "url": "https://unsplash.com/photos/Zr2nVd8Ks4f"
      },
      {
        "photo_id": "Lt6pJc1Wy9h",
        "description": "Open kitchen with morning light",
        "url": "https://unsplash.com/photos/Lt6pJc1Wy9h"
      }
    ],
    "next_cursor": ""
  }

ToolWhat it doesAccess

• create_collection Create a new collection in your account. writeasks first

  Returns the new collection ID, title, visibility and link. A public collection is visible to everyone on Unsplash, so the call waits for your OK. Pass private true to keep it to yourself; you can change it later with update_collection. By default you confirm each call; you can switch that off for this tool.

  MCP callunsplash_write → create_collection

  REST endpointPOST https://cotlet.dev/api/v1/unsplash/collections

  Parameters

  Parameters: create_collection

  Name	Type	Description
  title string required	string	Collection title.
  description string	string	Collection description.
  private boolean	boolean	true makes the collection private. Default: public.

  Example input

  {
    "title": "title"
  }

  Example response

  {
    "collection_id": "9034502",
    "title": "Spring launch",
    "visibility": "private",
    "total_photos": 0,
    "url": "https://unsplash.com/collections/9034502/spring-launch"
  }

• update_collection Change the title, description or visibility of one of your collections. writeasks first

  Returns the collection as it is after the change. Only collections your account owns can be edited; any other returns APP_PERMISSION_DENIED. Making a collection public shows it to everyone on Unsplash, so the call waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callunsplash_write → update_collection

  REST endpointPATCH https://cotlet.dev/api/v1/unsplash/collections/{collection_id}

  Parameters

  Parameters: update_collection

  Name	Type	Description
  collection_id string required	string	Collection ID from search_collections or list_my_collections.
  title string	string	New title.
  description string	string	New description.
  private boolean	boolean	true makes the collection private, false makes it public.

  Example input

  {
    "collection_id": "collection_8c41d2"
  }

  Example response

  {
    "collection_id": "9034502",
    "title": "Spring launch 2027",
    "visibility": "private",
    "total_photos": 9
  }

• add_photo_to_collection Add a photo to one of your collections. writeasks first

  Returns the collection with its new photo count. A photo that is already in the collection is not added twice. Collections that are public show the new photo to everyone on Unsplash, so the call waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callunsplash_write → add_photo_to_collection

  REST endpointPOST https://cotlet.dev/api/v1/unsplash/collections/{collection_id}/photos/{photo_id}/to-collection

  Parameters

  Parameters: add_photo_to_collection

  Name	Type	Description
  collection_id string required	string	Collection ID from search_collections or list_my_collections.
  photo_id string required	string	Photo ID from search_photos, get_photo or list_collection_photos.

  Example input

  {
    "collection_id": "9034471",
    "photo_id": "Hy4kT9xQe2A"
  }

  Example response

  {
    "collection_id": "9034471",
    "title": "Blog hero images",
    "photo_id": "Hy4kT9xQe2A",
    "total_photos": 25
  }

• remove_photo_from_collection Remove a photo from one of your collections. write

  Returns the collection with its new photo count. The photo stays on Unsplash; only the link to your collection goes. It reaches no one and is undone in one call with add_photo_to_collection, so it does not wait for your OK.

  MCP callunsplash_write → remove_photo_from_collection

  REST endpointDELETE https://cotlet.dev/api/v1/unsplash/collections/{collection_id}/photos/{photo_id}/from-collection

  Parameters

  Parameters: remove_photo_from_collection

  Name	Type	Description
  collection_id string required	string	Collection ID from search_collections or list_my_collections.
  photo_id string required	string	Photo ID from search_photos, get_photo or list_collection_photos.

  Example input

  {
    "collection_id": "collection_8c41d2",
    "photo_id": "photo_8c41d2"
  }

  Example response

  {
    "collection_id": "9034471",
    "title": "Blog hero images",
    "photo_id": "Qm7bLw3Rn5c",
    "total_photos": 23
  }