English
Connect your AI
Vesper speaks MCP, so Claude and other MCP clients can read and write your entries.
Add the server
- Copy the MCP address from Settings → Connections → AI clients (MCP). It looks like
https://noted-this.date/mcp. - Add it as a remote MCP server in your client.
- The client opens Vesper in your browser. Sign in, unlock, choose the workspace and allow access.
The client never sees your passkey. It gets a token that can unlock this one workspace, within the scopes you allowed.
What it can do
| Tool | What it does | Needs |
|---|---|---|
list_entries | Entries newest first, with photos; fromDate, toDate, tag, next | read |
search_entries | Entries whose text or tags contain a query; fromDate, toDate, tag, next | read |
get_entry | One entry with its full Markdown, metadata and photos | read |
list_photos | Photos with taken time, place and camera details; fromDate, toDate, tag, next | read |
list_tags | Tags and how many entries use each | read |
create_entry | Write a new entry (photos are added in the app) | write (Pro) |
update_entry | Change text, tags, visibility, pinned, favorite or archived | write (Pro) |
change_tag | Rename a tag on every entry, or remove it | write (Pro) |
delete_entry | Delete an entry for good | write (Pro) |
Dates are YYYY-MM-DD in UTC, and toDate includes the whole day. Lists come a page at a time: 50 entries, or the photos of 24 entries; pass the next a page returns to get the one after it.
The server uses Streamable HTTP at /mcp and lists its OAuth server at /.well-known/oauth-protected-resource/mcp, so clients find the sign-in page themselves.
Scripts
For scripts, use a personal token with the personal API.