add_annotation
ChatGPTHighlight exact article text or attach a note to an image. Use get_reader_content first and copy the quote or image URL exactly. Text annotations accept optional prefix/suffix context to disambiguate repeated quotes. The body may be empty to create a highlight without a note. Image annotations apply to the whole image.
archive_bookmark
ChatGPTArchive or unarchive a bookmark by id. Archived bookmarks leave the active library but are kept and remain readable. Args: - bookmarkId (string, required) - archived (boolean, required): true to archive, false to unarchive
browse_library
ChatGPTFetch a page of bookmarks and tags for the library UI without reopening it.
create_tag
ChatGPTCreate a tag so it exists before bookmarking. Idempotent: creating an existing tag returns it unchanged. To create a tag AND attach it to bookmarks in one step, call tag_bookmarks instead.
delete_bookmark
ChatGPTPermanently delete a bookmark by id, including its tags and comments. This cannot be undone — prefer archive_bookmark unless the user asked to delete.
delete_tag
ChatGPTDelete a tag by name and remove it from every bookmark. The bookmarks themselves are kept.
get_bookmark
ChatGPTFetch full metadata for one bookmark by id: URL, title, description, tags, archive state, reader status, and reading time. Use list_bookmarks or search_bookmarks first to find the id.
get_reader_content
ChatGPTRead the saved article text and image references for one bookmark. Use this before add_annotation so text quotes and image URLs match the saved reader content exactly. Returns stored content only; it does not access the open web.
list_annotations
ChatGPTList text highlights and image annotations, newest first — either across the library or on one bookmark. Returns each annotation's id, note, anchor, bookmark, and timestamp. Args: - bookmarkId (string, optional): only annotations on this bookmark
list_bookmarks
ChatGPTList the user's saved bookmarks, newest first. Args: - archived (boolean, default false): true lists archived bookmarks instead of active ones - tag (string, optional): only bookmarks carrying this tag - limit (number, 1-100, default 20), offset (number, default 0): pagination Returns one block per bookmark with id, url, title, tags, and saved date.
list_tags
ChatGPTList the user's tags with how many active bookmarks carry each one.
open_library
ChatGPTOpen the user's Save This One bookmark library with clickable tags, search, and a reading view. Use when the user wants to browse their bookmarks visually.
open_reader
ChatGPTOpen a saved bookmark in the visual reader. Find its bookmarkId with list_bookmarks or search_bookmarks first. Only stored article content is read; unavailable content offers the original link.
read_bookmark
ChatGPTFetch a bookmark and its saved article for the reader UI without reopening it.
save_bookmark
ChatGPTSave a URL to the user's Save This One library. Fetches the page to extract its title, description, and reading-time metadata automatically — do not pass a title unless the fetch failed or you want to override it. Saving a URL that is already saved returns the existing bookmark and changes nothing. Args: - url (string, required): Full http(s) URL, e.g. https://example.com/article - tags (string[], optional): Tag names to attach. New tags are created automatically. Examples: - Use when: the user says "save this link: https://..." or "bookmark this article under reading-list" - Don't use for searching — use search_bookmarks instead.
search_bookmarks
ChatGPTSearch the user's active bookmarks by keyword. Matches against title, description, URL, domain, and site name (case-insensitive substring). For tag-scoped browsing without a keyword use list_bookmarks with the tag argument. Args: - query (string, required): keywords to search for - limit (number, 1-100, default 20)
tag_bookmarks
ChatGPTAttach or remove tags on one or more bookmarks. Tags are created automatically when tagging. Args: - bookmarkIds (string[], required): one or more bookmark ids - tags (string[], required): tag names to attach or remove - linked (boolean, required): true to attach the tags, false to remove them
whoami
ChatGPTShow the account this connection is authorized for: Clerk user, email, linked Save This One profile, and granted OAuth scopes. Use when unsure which account is connected.