Before you start
Every action on this page runs through the Rawback MCP server at https://api.rawback.app/v3/mcp. If you have not added the connector yet, set it up first — the assistant discovers the sign-in flow on its own once you point it at that URL.
Three things apply to everything below.
The connector is part of a paid plan. You can add it on the free plan, but every action refuses with an upgrade message until the account has a membership.
Access covers your own library only. There is no action that reaches another person's photos, albums or stories, whatever the assistant is asked.
Secret albums are invisible to the connector. They are unlocked by typing a private keyword in the web app, and nothing here lists them, opens them by ID, or reads the stories written for them.
Reconnect to use videos and album stories
Video and album-story actions need permissions that did not exist when older connections were approved. If you added the connector before those actions shipped, the assistant will say a permission was not granted — remove the connector and add it again to grant them.
Photos and tags
| Action | What it does | Permission |
|---|---|---|
search_images | Search by free text, camera, lens, city, country, date range, rating, aperture or focal length. Also filters archived photos and sorts by rating. | Photos · read |
get_image | One photo in full: description, AI title and description, tags, exposure settings, location, album membership and image URLs. | Photos · read |
list_people | The people in your face library. | Photos · read |
list_tags | Your tags, optionally filtered by keyword. | Photos · read |
update_image | Change a photo's title, description or rotation. | Photos · write |
archive_image | Move a photo to the archive. Reversible. | Photos · write |
unarchive_image | Restore an archived photo. | Photos · write |
delete_image | Permanently delete a photo and its stored files. | Photos · write |
create_tag | Create a tag, with an optional colour. | Photos · write |
add_tags_to_image | Apply one or more tags to a photo. | Photos · write |
remove_tags_from_image | Remove tags from a photo. | Photos · write |
Ask for these in your own words — "find the shots from Lisbon last spring rated four or better", "tag everything from the harbour trip", "archive the out-of-focus ones".
Archive rather than delete
archive_image is reversible; delete_image is not, and the tool description
tells the assistant to prefer archiving unless you asked for deletion
outright.
Albums and shares
| Action | What it does | Permission |
|---|---|---|
search_albums | List or search your albums by name. | Albums · read |
get_album | One album with a page of the photos inside it. | Albums · read |
list_shares | The public share links you have created, with their URLs and expiry. | Albums · read |
create_album | Create an album with a name, description and visibility. | Albums · write |
update_album | Rename an album, change its description or change who can see it. | Albums · write |
add_images_to_album | Add photos to an album. | Albums · write |
remove_images_from_album | Remove photos from an album. | Albums · write |
delete_album | Delete an album. The photos in it are not deleted. | Albums · write |
Album stories
A story is an album's written companion: Markdown plus an ordered selection of that album's photos. An album has at most one story, which is why there is no separate "create" action — upsert_article writes the album's story whether or not one already exists.
| Action | What it does | Permission |
|---|---|---|
list_articles | Your album stories, most recently edited first. Includes drafts. | Stories · read |
get_article | One story in full — its Markdown, its status, and the album photos it embeds. Identify it by story ID or by album ID. | Stories · read |
get_article_public_link | The story's public URL, or the reason it does not have one yet. | Stories · read |
upsert_article | Write or edit an album's story: title, Markdown body, and which album photos it embeds. | Stories · write |
publish_article | Publish the story to the album's audience, optionally putting it on the open web in the same step. | Stories · write |
unpublish_article | Return the story to draft. Always withdraws it from the open web too. | Stories · write |
set_article_web_public | Turn the open-web link on or off without changing whether the story is published. | Stories · write |
delete_article | Permanently delete the story and any pictures uploaded into it. The album is untouched. | Stories · write |
Published is not the same as public
Two separate switches, and it is worth knowing which is which:
- Published means everyone who can already reach the album can read the story. Sharing the album shares the story.
- On the open web means anyone at all can read it at
/articles/…, search engines included. It is off by default, and publishing alone never turns it on.
A draft cannot go on the open web — publish it first. Returning a story to draft always pulls it back off.
Ask before it goes public
set_article_web_public and publish_article with the web option are the
only actions here that expose anything outside your account. Make sure the
assistant is acting on a request you actually made.
Embedded pictures
Story Markdown embeds pictures as stable tokens rather than URLs: rawback://image/{id} for a photo drawn from the album, and rawback://article-image/{id} for a picture uploaded to the story itself. An assistant editing a story should leave those tokens intact — Rawback resolves them to real images when the page is rendered.
Pictures can only be uploaded into a story from the web editor. The connector can rearrange and embed what is already there, not add new files.
Videos
| Action | What it does | Permission |
|---|---|---|
list_videos | Your videos, newest first. Only uploads that finished appear here. | Videos · read |
get_video | One video's details: duration, dimensions, codecs, playback and poster-frame URLs, and whether a transcript exists. Also finds uploads that are still in progress or failed. | Videos · read |
get_video_transcript | The speech-to-text transcript, as plain text or as SRT subtitle cues. | Videos · read |
update_video | Change a video's title or description. | Videos · write |
delete_video | Permanently delete a video with its poster frame, audio and transcript. | Videos · write |
The transcript is the reason this group is worth connecting: it lets an assistant answer questions about what was actually said in a recording, quote a passage, or find the clip where something came up.
Long transcripts are shortened so a single video cannot consume the whole conversation — ask for more if the assistant reports the text was cut short. A video only has a transcript once its audio has been uploaded and the background job has run, and transcription is a per-deployment setting; when there is none, the action explains why rather than failing.
Videos are uploaded from the apps, not the connector
Uploading a video needs the file itself and measurements taken from it before the upload starts, which is work the desktop app, the CLI and iOS do on your machine. There is no upload action here — use one of those, then come back and the connector will see the result.
Account, recaps and usage
| Action | What it does | Permission |
|---|---|---|
get_profile | Your name, email address and plan. | Account · read |
list_equipment | The cameras and lenses detected in your library. | Account · read |
list_notifications | Your notifications, optionally unread only. | Account · read |
list_dreams | Your daily AI photo recaps. | Photos · read |
get_dream | One recap in full. | Photos · read |
mark_notifications_read | Mark one notification, or all of them, as read. | Account · write |
get_usage | Storage used, AI credit balance and face-recognition quota. | Usage · read |
ChatGPT compatibility
Two extra actions exist under names ChatGPT's connector platform requires:
| Action | What it does | Permission |
|---|---|---|
search | Searches photos, and albums as well when album access was granted. | Photos · read |
fetch | Retrieves one photo or album by ID. | Photos or Albums · read |
They are aliases over the actions above and do nothing the others cannot. Claude and other MCP clients use the specific ones.
Permissions
The consent screen groups permissions by what they touch rather than listing raw scopes. There are six groups, each with a read half and — except for Usage — a write half:
| Group | Read | Write |
|---|---|---|
| Photos | Browse, search and open your photos | Edit, tag, archive and delete them |
| Albums | See albums, their contents and your share links | Create, rename, delete and re-fill albums |
| Videos | See videos and read their transcripts | Edit titles and descriptions, delete videos |
| Album stories | Read your stories, drafts included | Write, publish, put on the open web, delete |
| Account | Name, email, plan, equipment, notifications | Mark notifications as read |
| Usage | Storage, AI credits, face-recognition quota | — |
Claude and ChatGPT do not let you tick individual boxes when adding a connector, so a grant is all-or-nothing — the groups exist so that what you are approving is legible before you approve it. Review it on the consent screen; to withdraw everything, remove the connector in the assistant you added it to.
Actions that change data are marked as such in the protocol itself, so a client can ask you to confirm before running one. Deleting a photo, album, video or story is marked more strongly again, and the assistant has to state the intent explicitly before the action will run at all.
Limits and safety
Deletion is permanent. delete_image, delete_album, delete_video and delete_article each require the assistant to confirm the intent explicitly, and none of them can be undone afterwards. Archiving a photo or unpublishing a story is the reversible alternative.
Assistants misread requests. Write access is real access. Grant it to apps you trust, and read what a destructive action says before approving it.
Lists are paginated. Anything that returns a list takes a page number and a page size up to 100, and reports how many results exist in total. If the assistant seems to have seen only part of your library, ask it for the next page.
Some things are deliberately out of reach. Uploading photos or videos, editing photos with AI, and managing billing are not connector actions — they live in the apps and on the website.