{
  "info": {
    "name": "Google Photos — mcp.ai",
    "description": "REST API for the Google Photos MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/googlephotos",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "googlephotos_add_enrichment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/enrichment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "enrichment"
          ]
        },
        "description": "Adds an enrichment at a specified position in a defined album.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"albumId\": \"\",\n  \"albumPosition\": {},\n  \"newEnrichmentItem\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_batch_add_media_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/add/media/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "add",
            "media",
            "items"
          ]
        },
        "description": "Adds one or more media items to an album in google photos.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"albumId\": \"\",\n  \"mediaItemIds\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_batch_create_media_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/create/media/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "create",
            "media",
            "items"
          ]
        },
        "description": "Unified action to upload media files and create them as items in google photos.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"files\": \"\",\n  \"albumId\": \"\",\n  \"albumPosition\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_batch_get_media_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/get/media/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "get",
            "media",
            "items"
          ]
        },
        "description": "Returns the list of media items for the specified media item identifiers.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mediaItemIds\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_create_album",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/album",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "album"
          ]
        },
        "description": "Creates a new album in google photos.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"title\": \"\",\n  \"productUrl\": \"\",\n  \"isWriteable\": false,\n  \"mediaItemsCount\": \"\",\n  \"coverPhotoBaseUrl\": \"\",\n  \"coverPhotoMediaItemId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_get_album",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/album",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "album"
          ]
        },
        "description": "Returns the album based on the specified albumid.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"albumId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_get_media_item_download",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/media/item/download",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "media",
            "item",
            "download"
          ]
        },
        "description": "Downloads a media item from google photos and returns it as a file.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mediaItemId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_list_albums",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/albums",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "albums"
          ]
        },
        "description": "Lists all albums shown to a user in the albums tab of google photos.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"pageSize\": 0,\n  \"pageToken\": \"\",\n  \"excludeNonAppCreatedData\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_list_media_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/media/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "media",
            "items"
          ]
        },
        "description": "Lists all media items from a user's google photos library.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"pageSize\": 0,\n  \"pageToken\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_search_media_items",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/media/items",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "media",
            "items"
          ]
        },
        "description": "Searches for media items in a user's google photos library.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"albumId\": \"\",\n  \"filters\": {},\n  \"orderBy\": \"\",\n  \"pageSize\": 0,\n  \"pageToken\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_update_album",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/album",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "album"
          ]
        },
        "description": "Updates an album's title or cover photo in google photos.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"albumId\": \"\",\n  \"coverPhotoMediaItemId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_update_media_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/media/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "media",
            "item"
          ]
        },
        "description": "Updates a media item's description in google photos.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"description\": \"\",\n  \"mediaItemId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "googlephotos_upload_media",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/media",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "media"
          ]
        },
        "description": "Upload a media file to google photos. supports images (up to 200mb) and videos (up to 20gb).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"description\": \"\",\n  \"file_to_upload\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}