ShareWatch

Write markdown content into a Google Doc with full formatting — headings, bold, italic, bullets, numbered lists, links, and horizontal rules. Use this instead of create_document or update_document when the content has structure that should be visually formatted. Pass file_id to replace an existing doc's content, or omit to create a new doc.

format_document

Inspect the layout of every slide without rendering images. Returns a geometry-level readback — each element's position, size and text, plus flags for content that overflows the slide bounds, overlaps another element, or uses a sub-legible font. Cheap (no image render) — use it to catch mechanical layout problems while editing; use preview_slides for the final visual pass.

describe_slides

List the Google Workspace files ShareWatch can see. This is not the user's Drive — it is only what was created through ShareWatch plus what the user has explicitly shared with it, so a short list means a narrow grant and an empty one does not mean an empty Drive. Never tell the user a file does not exist on this basis; a file you cannot see here may still be there. Google grants access per file, so sharing a folder does not share what is inside it: files in a shared folder appear only if they were shared themselves. If the user expected a folder's contents, ask them to open the folder in the picker and select the files (several at once is fine). Returns file IDs, names, types, URLs, and each file's parent folder — folders appear as entries too, so parent_folder_id is what tells you which files live inside which folder.

list_files

Move a file into a different folder. Both the file and destination folder must be accessible to ShareWatch.

move_file

When a user shares a Google Drive URL or asks you to access a specific file, use this tool. Accepts any Google Drive, Docs, Sheets or Slides URL and resolves it against the Google Drive API (https://developers.google.com/drive/api/reference/rest/v3). If the file is already accessible, returns its content. If not, returns a grant link the user can open to select it. If the user mentions the file's name, pass it as file_name_hint so the picker can search for it.

access_file_by_url

Get thumbnail images for all slides in a Google Slides presentation. Returns rendered PNG images of each slide. Use this for a final visual check of layout and formatting.

preview_slides

Read the text content of a Google Doc, Sheet, or Slides presentation. Docs export as plain text, Sheets as CSV, Slides as plain text. For large files, returns a size warning instead of content — use max_chars and offset to read in chunks. file_id also accepts a ShareWatch handoff code of the form SW-XXXXXXXX. The user gets one by opening a file from Google Drive with ShareWatch, and it stands for that file until it goes unused for 30 days. The result always reports the real file_id, so use that value for any follow-up call rather than the code.

read_file

Tell the ShareWatch developers what this server got wrong. Use it for outright bugs — an unexpected error, a wrong result — and equally for friction: a confusing parameter, an unhelpful error message, a task that took three calls when it should have taken one. Your assessment of the API is the point; it is the only way its designers learn how it behaves in practice. The report is written to the user's own audit log, visible to them and to their workspace administrators, and to ShareWatch's operational logs. Write about the tool, never about the user's documents or conversation. Before filing, check that the behaviour is not one of these, which are by design and not bugs: (1) Google grants access per FILE — sharing a folder does not share its contents, and files inside appear only when shared themselves; (2) list_files and search_files see only what the user has shared, never their whole Drive; (3) Drive's Open With menu never grants Google Docs, Sheets or Slides — the picker does; (4) a file whose owner turned off download and copy for viewers cannot be read through any API — only its owner can change that; (5) get_status.available_tools lists what the server implements, not what this caller may use. If the user has one of these, explain it to them instead of reporting it; the docs at https://sharewatch.ai/docs.html cover each.

report_bug

When a user wants you to access a file that isn't in the file list, call this tool. It returns a URL the user can open to select and grant access to files from their Google Drive.

request_file_access

Search for files by name, text content, type, or date range. Use this instead of list_files when the user has many files or is looking for something specific. Use content when the user remembers what a file says but not what it is called. All parameters are optional — combine them to narrow results. Searches only what the user has shared with ShareWatch, and a shared folder does not share its contents — files inside it must be shared themselves.

search_files

Mark a file as read-only. Read-only files can be read but not updated through ShareWatch. This is enforced at the proxy layer regardless of Google Drive permissions. One direction only: read_only=false is refused, because only the user can make a file writable again, from the ShareWatch Files page.

set_file_read_only

Update an existing Google Doc. Supports replacing all content or appending to it. The result reports the mode that was actually applied and how many characters were written, so you can confirm a replace was a replace.

update_document

Modify an existing Google Slides presentation. Structured operations (operations_json): add_slide, insert_text, delete_text, delete_slide, replace_text, update_text_style, update_page_bg. Google's own spellings are accepted where the operation is identical — replace_all_text and create_slide both work. An unrecognised type, or one missing a required field, is REJECTED with a message naming the operation; nothing is silently skipped. Examples: - delete_text: {"type":"delete_text","element_id":"id"} - replace_text: {"type":"replace_text","old_text":"foo","new_text":"bar"} - update_text_style: {"type":"update_text_style","element_id":"id","bold":true,"font_size":24,"color":"#1a56db"} - update_page_bg: {"type":"update_page_bg","slide_id":"id","bg_color":"#1a1a2e"} Raw mode (raw_requests): Pass a Google Slides API BatchUpdatePresentationRequest body directly for full API access. Request shapes are documented at https://developers.google.com/slides/api/reference/rest/v1/presentations/batchUpdate

update_presentation

Write data to a range in an existing Google Sheet. The range must reference a tab that already exists (e.g. 'Overview!A1' requires an 'Overview' tab). Errors with 'Unable to parse range' if the tab name is unknown — call add_sheet_tab first to create new tabs. Values are stored EXACTLY AS GIVEN by default, so '=B1+B2' is saved as text and does not calculate; pass value_input_option='USER_ENTERED' to write real formulas. The result carries formula_notice when cells starting with '=' were stored as text.

update_spreadsheet

Upload a binary file (xlsx, pdf, docx, png, etc.) to Drive from base64-encoded content. Use this when you have file bytes from the conversation (e.g. an attached spreadsheet) and need to put them in the user's Drive. Set convert=true to have Drive convert Office formats to native Google formats during upload. Maximum 20MB decoded.

upload_file