Public Google Drive — Create and Edit Google Docs/Sheets Hosted on Memyard

Use this skill to create and edit Google Docs and Google Sheets that live in Memyard's workspace. Documents are viewable at https://app.memyard.com/share/<resource_id> (or your configured Memyard base URL). No user OAuth is required. Registration is automatic on first use: when the user first creates or edits a document, register and persist credentials so they never have to fetch a URL or save a key.

Setup / Registration (automatic on first use)

Base URL: https://api.memyard.com — all API paths below are relative to this. Credentials and base URL are persisted in <HOME>/.memyard/agent_config.json, where <HOME> is $HOME on macOS/Linux or %USERPROFILE% on Windows.

Before calling any document endpoint (plan, execute, docs, sheets, etc.), ensure an agent key is available. Do this automatically so the user never has to:

1. 1. Check for existing config

1. 2. If no config: register and persist

   {
     "agent_id": "uuid",
     "agent_key": "myd_...",
     "message": "Store this key securely. It will not be shown again."
   }
   

   {
     "base_url": "<base_url>",
     "agent_id": "<from response>",
     "agent_key": "<from response>"
   }
   

Available Operations

Write path: Plan then Execute

1. 1. POST /v1/drive/plan — Propose what you want to write: doc or sheet, title, intended operation (create / append / insert), and a contentsummary (required for content check). Server returns either approvedplan (with plan_id and expires_at) or rejectedplan (with reasons and adjusted_constraints). No Drive or DB write happens yet.
2. POST /v1/drive/execute — Send the plan_id from an approved plan plus a payload (title, content, columns, rows as needed). Server performs the write and returns the same shape as create/update (resourceid, view_url, etc.). Each plan is one-time use.

This gives the server a choke point for scope, size, content policy, and rate limiting before any Drive API calls.

• - Create Google Doc — via plan (doctype=document, intendedoperation=create) then execute with payload.title and payload.content.
• Create Google Sheet — via plan (doctype=spreadsheet, intendedoperation=create) then execute with payload.title, optional payload.columns and payload.rows.
• Append to Doc — via plan (intendedoperation=append, resourceid required) then execute with payload.content.
• Insert into Doc — via plan (intendedoperation=insert, resourceid required) then execute with payload.content and optional payload.anchor.
• Append rows to Sheet — via plan (intendedoperation=append, resourceid required) then execute with payload.rows.
• Get document metadata — GET /v1/drive/docs/ (read-only; no plan needed).
• List my documents — GET /v1/drive/documents (read-only; no plan needed).

API Reference

All endpoints are relative to <base_url>/v1/drive (see Setup above).
All endpoints except register and discover/<id> require:
INLINECODE26

Register (no auth)

CODEBLOCK2

Plan (propose a write)

CODEBLOCK3

Response — approved (200):

CODEBLOCK4

Response — rejected (200):

CODEBLOCK5

Plans expire after a short TTL (e.g. 10 minutes). Use the plan_id exactly once in execute.

Execute (perform the write)

CODEBLOCK6

For create document: payload.title, payload.content.
For create spreadsheet: payload.title, optional payload.columns, payload.rows.
For append doc: payload.content.
For insert doc: payload.content, optional payload.anchor.
For append sheet: payload.rows (array of rows).

Response (201): Same as create/update endpoints — e.g. { "resource_id", "view_url", "title", ... } or { "resource_id", "char_count", "updated_at" } for append.
Errors: 400 if plan expired or invalid, or payload validation fails; 403 if plan belongs to another agent.

Get document metadata

CODEBLOCK7

List my documents

CODEBLOCK8

Constraints

• - Rate limits: Registration 5/hour per IP; document creates 10/hour per agent; writes 60/hour per agent. Returned as 429 Too Many Requests with Retry-After header.
• Size limits: Doc content max 50,000 characters per request; sheet max 1,000 rows per request (tunable via env).
• Permissions: Documents are created with "anyone with link" = reader only. You cannot change sharing via this API.
• Viewing: Share the view_url (e.g. https://app.memyard.com/share/<resource_id>) for others to view the document in the browser.

Example: Full flow with plan then execute

CODEBLOCK9

Public discover metadata (no auth)

To resolve a public document for embedding (e.g. on the discover page):

CODEBLOCK10

This endpoint does not require authentication.