Overview
Read your Savee saves, boards, and feed — from an AI assistant over MCP, or from your own code over the REST API.
Savee is a curated visual-inspiration platform for designers and creative professionals. Members save images and video from anywhere on the web into boards, and discover work through color, tags, and visual similarity.
This is the developer documentation for reading your own Savee data.
Two ways in
Both surfaces read the same data with the same visibility rules, and neither can write anything — there are no endpoints or tools that create, edit, or delete.
| MCP | REST API | |
|---|---|---|
| Best for | AI assistants and coding agents | Your own code and integrations |
| Offered as | Remote MCP server | REST API over HTTPS |
| Authorization | OAuth — approve in the browser | API token (Bearer) |
| You write | Nothing. Ask in plain language | HTTP requests |
| Requires | An active Savee subscription | An active Savee subscription |
Get started with MCP →
Connect Savee to Claude, Cursor, or any MCP client.
Get started with the API →
Generate a token and make your first call in under a minute.
Which one do I want?
If you want an assistant to read your Savee library — summarise what you've been saving, describe the direction a board is taking, pull source links for a moodboard — use MCP. You connect once in your browser and then ask in plain language; there's no token to manage and no code to write.
If you're building something — embedding your latest saves on your own site, a dashboard, a script — use the REST API. It's seven endpoints and a Bearer token.
They're not exclusive. The MCP server is built on the same queries the REST API serves, so anything an assistant can read, your code can read too.
What you can read
- Your saves, newest first, including private ones. One exception: if you've turned on Hide private board saves from profile feed in your settings, saves that sit in a private board are left out here too.
- Your boards — the ones you own, the ones you've been added to as a collaborator, and any team boards from Savee Teams workspaces you're a member of — and the saves on each.
- Your home feed (saves from people you follow).
- Your own profile info.
What's deliberately missing
So you don't go looking:
- Writing anything — no creating saves, boards, or follows.
- Search and tags — deferred until there's real usage to design against.
- Other people's data — beyond what already reaches your feed and your shared boards.
Acceptable use
Use these APIs to build integrations that complement Savee for your own data. Automated crawling, systematic downloading of content, or any form of structured data harvesting from other users is not permitted.