google-docs

Dependency-free local emulator for Google Docs API v1 JSON REST calls. It is designed for googleapis Docs clients, raw fetch, MCP preview URLs, and AI-agent tests that need documents.create, documents.get, and documents.batchUpdate without calling https://docs.googleapis.com/v1.

Default port: 4616

Quick start

import { google } from "googleapis";
import { GoogleDocsServer } from "./services/google-docs/src/server.js";

const server = new GoogleDocsServer(4616);
await server.start();

const docs = google.docs({ version: "v1", auth: "not-used-by-parlel" });
docs.context._options.rootUrl = "http://127.0.0.1:4616/";

const created = await docs.documents.create({
  requestBody: { title: "Parlel Notes" },
});

await docs.documents.batchUpdate({
  documentId: created.data.documentId,
  requestBody: {
    requests: [{ insertText: { location: { index: 1 }, text: "Hello from parlel\n" } }],
  },
});

const got = await docs.documents.get({ documentId: created.data.documentId });
console.log(got.data.body.content[0].paragraph.elements[0].textRun.content);

await server.stop();

Reset state with server.reset() or POST /_parlel/reset. Health is available at GET /_parlel/health.

Implemented operations

The server also accepts /docs/v1/... as an alias for raw clients. A simple googleapis rootUrl override should use the real discovery paths under /v1/....

Implemented documents.batchUpdate request variants include insertText, deleteContentRange, replaceAllText, updateTextStyle, createParagraphBullets, deleteParagraphBullets, updateParagraphStyle, createNamedRange, deleteNamedRange, replaceNamedRangeContent, insertInlineImage, replaceImage, insertTable, insertTableRow, insertTableColumn, deleteTableRow, deleteTableColumn, deleteTable, mergeTableCells, unmergeTableCells, updateTableCellStyle, updateTableColumnProperties, updateTableRowStyle, insertPageBreak, insertSectionBreak, updateDocumentStyle, updateSectionStyle, createHeader, deleteHeader, createFooter, deleteFooter, createFootnote, deletePositionedObject, pinTableHeaderRows, addDocumentTab, deleteTab, updateDocumentTabProperties, updateNamedStyle, insertDate, insertPerson, and insertRichLink.

Access via MCP / preview URL

When run inside a parlel sandbox, point Google Docs API clients at the preview URL or local base URL, for example http://127.0.0.1:4616/. Node googleapis users can set docs.context._options.rootUrl; raw clients can call /v1/documents, /v1/documents/{documentId}, and /v1/documents/{documentId}:batchUpdate directly. MCP-driven agents can reset state between scenarios with POST /_parlel/reset.

Surface coverage

Legend: ✅ supported · ◐ accepted-not-enforced · ✓ by design · ⟳ roadmap.

Error codes & shapes

Errors use Google JSON API-style envelopes with HTTP status, error.code, error.message, error.status, and a legacy error.errors[] reason array:

{
  "error": {
    "code": 404,
    "message": "Requested entity was not found.",
    "status": "NOT_FOUND",
    "errors": [
      {
        "message": "Requested entity was not found.",
        "domain": "global",
        "reason": "notFound"
      }
    ]
  }
}

Common codes:

Because auth is accepted-not-enforced, the emulator does not emit real Google 401 UNAUTHENTICATED responses for missing or invalid OAuth credentials.

Manifest

See services/google-docs/manifest.json:

• name: google-docs, image: parlel/google-docs:0.1
• port: 4616, protocol: http, healthcheck: /_parlel/health, startup approximately 100ms
• env: GOOGLE_DOCS_EMULATOR_HOST, GOOGLE_CLOUD_PROJECT, GCLOUD_PROJECT

Configuration — test.env

Copy these into your test.env (used by the bridge sidecar flow). Tokens are Parlel's seeded test credentials — any non-empty value is accepted by the emulator, so you rarely need to change them. Swap in real credentials only when pointing at the live service in prod.env.

GOOGLE_DOCS_EMULATOR_HOST=http://parlel-bridge:4616
GOOGLE_CLOUD_PROJECT=parlel
GCLOUD_PROJECT=parlel