gogcli-mcp 1.0.5 → 1.0.7

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gogcli-mcp",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "MCP server wrapping gogcli for Google service access",
   "repository": {
     "type": "git",
@@ -10,9 +10,13 @@
   "bin": {
     "gogcli-mcp": "dist/index.js"
   },
+  "exports": {
+    ".": "./dist/index.js",
+    "./lib": "./dist/lib.js"
+  },
   "scripts": {
     "build": "tsc --noEmit && npm run bundle",
-    "bundle": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js",
+    "bundle": "node ../../scripts/bundle.js src/index.ts dist/index.js && node ../../scripts/bundle.js src/lib.ts dist/lib.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",

package/src/index.ts

@@ -1,28 +1,7 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { registerAuthTools } from './tools/auth.js';
-import { registerCalendarTools } from './tools/calendar.js';
-import { registerContactsTools } from './tools/contacts.js';
-import { registerDocsTools } from './tools/docs.js';
-import { registerDriveTools } from './tools/drive.js';
-import { registerGmailTools } from './tools/gmail.js';
-import { registerSheetsTools } from './tools/sheets.js';
-import { registerTasksTools } from './tools/tasks.js';
-
-const server = new McpServer({ name: 'gogcli', version: '1.0.5' });
-
-registerAuthTools(server);
-registerCalendarTools(server);
-registerContactsTools(server);
-registerDocsTools(server);
-registerDriveTools(server);
-registerGmailTools(server);
-registerSheetsTools(server);
-registerTasksTools(server);
-
-// To add more services: import registerXxxTools and call them here.
-// Example: registerGmailTools(server);
+import { createBaseServer } from './server.js';
 
+const server = createBaseServer();
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/src/lib.ts

@@ -0,0 +1,5 @@
+export { createBaseServer, VERSION } from './server.js';
+export { run } from './runner.js';
+export type { RunOptions, Spawner } from './runner.js';
+export { accountParam, runOrDiagnose, toText, toError } from './tools/utils.js';
+export type { ToolResult } from './tools/utils.js';

package/src/server.ts

@@ -0,0 +1,31 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerAuthTools } from './tools/auth.js';
+import { registerCalendarTools } from './tools/calendar.js';
+import { registerContactsTools } from './tools/contacts.js';
+import { registerDocsTools } from './tools/docs.js';
+import { registerDriveTools } from './tools/drive.js';
+import { registerGmailTools } from './tools/gmail.js';
+import { registerSheetsTools } from './tools/sheets.js';
+import { registerTasksTools } from './tools/tasks.js';
+
+// Injected at build time by esbuild --define:GOGCLI_VERSION=...
+declare const GOGCLI_VERSION: string;
+export const VERSION = typeof GOGCLI_VERSION !== 'undefined' ? GOGCLI_VERSION : '0.0.0';
+
+export function createBaseServer(options?: { name?: string; version?: string }): McpServer {
+  const server = new McpServer({
+    name: options?.name ?? 'gogcli',
+    version: options?.version ?? VERSION,
+  });
+
+  registerAuthTools(server);
+  registerCalendarTools(server);
+  registerContactsTools(server);
+  registerDocsTools(server);
+  registerDriveTools(server);
+  registerGmailTools(server);
+  registerSheetsTools(server);
+  registerTasksTools(server);
+
+  return server;
+}

package/src/tools/docs.ts

@@ -74,89 +74,6 @@ export function registerDocsTools(server: McpServer): void {
     return runOrDiagnose(['docs', 'structure', docId], { account });
   });
 
-  // --- Comments tools ---
-
-  server.registerTool('gog_docs_comments_list', {
-    description:
-      'List comments on a Google Doc. Returns open comments by default; set includeResolved=true to include resolved comments.',
-    annotations: { readOnlyHint: true },
-    inputSchema: {
-      docId: z.string().describe('Doc ID (from the URL)'),
-      includeResolved: z.boolean().optional().describe('Include resolved comments (default: false, open only)'),
-      account: accountParam,
-    },
-  }, async ({ docId, includeResolved, account }) => {
-    const args = ['docs', 'comments', 'list', docId];
-    if (includeResolved) args.push('--include-resolved');
-    return runOrDiagnose(args, { account });
-  });
-
-  server.registerTool('gog_docs_comments_get', {
-    description: 'Get a single comment by ID, including its replies.',
-    annotations: { readOnlyHint: true },
-    inputSchema: {
-      docId: z.string().describe('Doc ID (from the URL)'),
-      commentId: z.string().describe('Comment ID'),
-      account: accountParam,
-    },
-  }, async ({ docId, commentId, account }) => {
-    return runOrDiagnose(['docs', 'comments', 'get', docId, commentId], { account });
-  });
-
-  server.registerTool('gog_docs_comments_add', {
-    description:
-      'Add a comment to a Google Doc. Optionally attach quoted text that appears as the highlighted passage in the Google Docs UI.',
-    inputSchema: {
-      docId: z.string().describe('Doc ID (from the URL)'),
-      content: z.string().describe('Comment text'),
-      quoted: z.string().optional().describe('Quoted text to attach to the comment (shown in UIs when available)'),
-      account: accountParam,
-    },
-  }, async ({ docId, content, quoted, account }) => {
-    const args = ['docs', 'comments', 'add', docId, content];
-    if (quoted) args.push(`--quoted=${quoted}`);
-    return runOrDiagnose(args, { account });
-  });
-
-  server.registerTool('gog_docs_comments_reply', {
-    description: 'Reply to an existing comment on a Google Doc.',
-    inputSchema: {
-      docId: z.string().describe('Doc ID (from the URL)'),
-      commentId: z.string().describe('Comment ID to reply to'),
-      content: z.string().describe('Reply text'),
-      account: accountParam,
-    },
-  }, async ({ docId, commentId, content, account }) => {
-    return runOrDiagnose(['docs', 'comments', 'reply', docId, commentId, content], { account });
-  });
-
-  server.registerTool('gog_docs_comments_resolve', {
-    description: 'Resolve a comment (mark as done). Optionally include a closing message.',
-    annotations: { destructiveHint: true },
-    inputSchema: {
-      docId: z.string().describe('Doc ID (from the URL)'),
-      commentId: z.string().describe('Comment ID to resolve'),
-      message: z.string().optional().describe('Optional message to include when resolving'),
-      account: accountParam,
-    },
-  }, async ({ docId, commentId, message, account }) => {
-    const args = ['docs', 'comments', 'resolve', docId, commentId];
-    if (message) args.push(`--message=${message}`);
-    return runOrDiagnose(args, { account });
-  });
-
-  server.registerTool('gog_docs_comments_delete', {
-    description: 'Delete a comment from a Google Doc. This action is permanent.',
-    annotations: { destructiveHint: true },
-    inputSchema: {
-      docId: z.string().describe('Doc ID (from the URL)'),
-      commentId: z.string().describe('Comment ID to delete'),
-      account: accountParam,
-    },
-  }, async ({ docId, commentId, account }) => {
-    return runOrDiagnose(['docs', 'comments', 'delete', docId, commentId], { account });
-  });
-
   server.registerTool('gog_docs_run', {
     description: 'Run any gog docs subcommand not covered by the other tools. Run `gog docs --help` for the full list of subcommands, or `gog docs <subcommand> --help` for flags on a specific subcommand.',
     annotations: { destructiveHint: true },

package/tests/tools/docs.test.ts

@@ -161,193 +161,6 @@ describe('gog_docs_structure', () => {
   });
 });
 
-// --- Comments tools ---
-
-describe('gog_docs_comments_list', () => {
-  it('calls run with correct args for open comments', async () => {
-    vi.mocked(runner.run).mockResolvedValue('[{"id":"c1","content":"Fix this"}]');
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_list')!({ docId: 'abc' });
-    expect(runner.run).toHaveBeenCalledWith(['docs', 'comments', 'list', 'abc'], { account: undefined });
-    expect(result.content[0].text).toContain('Fix this');
-  });
-
-  it('includes --include-resolved when set', async () => {
-    vi.mocked(runner.run).mockResolvedValue('[]');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_list')!({ docId: 'abc', includeResolved: true });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'list', 'abc', '--include-resolved'],
-      { account: undefined },
-    );
-  });
-
-  it('omits --include-resolved when false', async () => {
-    vi.mocked(runner.run).mockResolvedValue('[]');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_list')!({ docId: 'abc', includeResolved: false });
-    expect(runner.run).toHaveBeenCalledWith(['docs', 'comments', 'list', 'abc'], { account: undefined });
-  });
-
-  it('forwards account override', async () => {
-    vi.mocked(runner.run).mockResolvedValue('[]');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_list')!({ docId: 'abc', account: 'other@gmail.com' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'list', 'abc'],
-      { account: 'other@gmail.com' },
-    );
-  });
-
-  it('returns error text on failure', async () => {
-    vi.mocked(runner.run).mockRejectedValue(new Error('List failed'));
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_list')!({ docId: 'bad' });
-    expect(result.content[0].text).toContain('Error: List failed');
-  });
-});
-
-describe('gog_docs_comments_get', () => {
-  it('calls run with correct args', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{"id":"c1","content":"Fix this","replies":[]}');
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_get')!({ docId: 'abc', commentId: 'c1' });
-    expect(runner.run).toHaveBeenCalledWith(['docs', 'comments', 'get', 'abc', 'c1'], { account: undefined });
-    expect(result.content[0].text).toContain('Fix this');
-  });
-
-  it('returns error text on failure', async () => {
-    vi.mocked(runner.run).mockRejectedValue(new Error('Not found'));
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_get')!({ docId: 'abc', commentId: 'bad' });
-    expect(result.content[0].text).toContain('Error: Not found');
-  });
-});
-
-describe('gog_docs_comments_add', () => {
-  it('calls run with content', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{"id":"c2"}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_add')!({ docId: 'abc', content: 'Please review' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'add', 'abc', 'Please review'],
-      { account: undefined },
-    );
-  });
-
-  it('includes --quoted when provided', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{"id":"c2"}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_add')!({
-      docId: 'abc',
-      content: 'Typo here',
-      quoted: 'teh',
-    });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'add', 'abc', 'Typo here', '--quoted=teh'],
-      { account: undefined },
-    );
-  });
-
-  it('omits --quoted when not provided', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{"id":"c2"}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_add')!({ docId: 'abc', content: 'Nice' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'add', 'abc', 'Nice'],
-      { account: undefined },
-    );
-  });
-
-  it('returns error text on failure', async () => {
-    vi.mocked(runner.run).mockRejectedValue(new Error('Add failed'));
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_add')!({ docId: 'bad', content: 'x' });
-    expect(result.content[0].text).toContain('Error: Add failed');
-  });
-});
-
-describe('gog_docs_comments_reply', () => {
-  it('calls run with correct args', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{"id":"r1"}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_reply')!({ docId: 'abc', commentId: 'c1', content: 'Done' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'reply', 'abc', 'c1', 'Done'],
-      { account: undefined },
-    );
-  });
-
-  it('returns error text on failure', async () => {
-    vi.mocked(runner.run).mockRejectedValue(new Error('Reply failed'));
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_reply')!({
-      docId: 'abc', commentId: 'c1', content: 'x',
-    });
-    expect(result.content[0].text).toContain('Error: Reply failed');
-  });
-});
-
-describe('gog_docs_comments_resolve', () => {
-  it('calls run with correct args', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_resolve')!({ docId: 'abc', commentId: 'c1' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'resolve', 'abc', 'c1'],
-      { account: undefined },
-    );
-  });
-
-  it('includes --message when provided', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_resolve')!({
-      docId: 'abc', commentId: 'c1', message: 'Fixed in v2',
-    });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'resolve', 'abc', 'c1', '--message=Fixed in v2'],
-      { account: undefined },
-    );
-  });
-
-  it('omits --message when not provided', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_resolve')!({ docId: 'abc', commentId: 'c1' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'resolve', 'abc', 'c1'],
-      { account: undefined },
-    );
-  });
-
-  it('returns error text on failure', async () => {
-    vi.mocked(runner.run).mockRejectedValue(new Error('Resolve failed'));
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_resolve')!({ docId: 'abc', commentId: 'c1' });
-    expect(result.content[0].text).toContain('Error: Resolve failed');
-  });
-});
-
-describe('gog_docs_comments_delete', () => {
-  it('calls run with correct args', async () => {
-    vi.mocked(runner.run).mockResolvedValue('{}');
-    const handlers = setupHandlers();
-    await handlers.get('gog_docs_comments_delete')!({ docId: 'abc', commentId: 'c1' });
-    expect(runner.run).toHaveBeenCalledWith(
-      ['docs', 'comments', 'delete', 'abc', 'c1'],
-      { account: undefined },
-    );
-  });
-
-  it('returns error text on failure', async () => {
-    vi.mocked(runner.run).mockRejectedValue(new Error('Delete failed'));
-    const handlers = setupHandlers();
-    const result = await handlers.get('gog_docs_comments_delete')!({ docId: 'abc', commentId: 'c1' });
-    expect(result.content[0].text).toContain('Error: Delete failed');
-  });
-});
-
 describe('gog_docs_run', () => {
   it('passes raw subcommand and args to runner', async () => {
     vi.mocked(runner.run).mockResolvedValue('{}');

package/tsconfig.json

@@ -1,14 +1,8 @@
 {
+  "extends": "../../tsconfig.base.json",
   "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
     "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "types": ["node"]
+    "rootDir": "./src"
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist"]

package/.github/workflows/ci.yml

@@ -1,22 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-  workflow_call:
-
-jobs:
-  ci:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v6.0.2
-
-      - uses: actions/setup-node@v6.3.0
-        with:
-          node-version: 22
-          cache: npm
-
-      - run: npm ci
-      - run: npm run build
-      - run: npm test

package/.github/workflows/release.yml

@@ -1,76 +0,0 @@
-name: Release
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-jobs:
-  ci:
-    uses: ./.github/workflows/ci.yml
-
-  release:
-    needs: ci
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      id-token: write
-
-    steps:
-      - uses: actions/checkout@v6.0.2
-
-      - uses: actions/setup-node@v6.3.0
-        with:
-          node-version: 24
-          cache: npm
-          registry-url: https://registry.npmjs.org
-
-      # Strip always-auth from .npmrc (set by setup-node, deprecated in npm 11)
-      - run: sed -i '/always-auth/d' "$NPM_CONFIG_USERCONFIG"
-
-      - run: npm ci
-      - run: npm run build
-
-      - name: Extract version
-        run: |
-          VERSION=$(node -p "require('./package.json').version")
-          echo "VERSION=${VERSION}" >> "$GITHUB_ENV"
-
-      # Package the .skill file
-      - name: Package skill
-        run: |
-          python3 - <<'EOF'
-          import zipfile, pathlib, os
-
-          version = os.environ["VERSION"]
-          skill_name = "gogcli-mcp"
-          out = pathlib.Path(f"{skill_name}-{version}.skill")
-
-          with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as zf:
-              zf.write(pathlib.Path("SKILL.md"), f"{skill_name}/SKILL.md")
-
-          print(f"Packaged {out} ({out.stat().st_size} bytes)")
-          EOF
-
-      # Sync manifest.json version from package.json and build .mcpb
-      - name: Build .mcpb bundle
-        run: |
-          node -e "
-            const fs = require('fs');
-            const m = JSON.parse(fs.readFileSync('manifest.json', 'utf8'));
-            m.version = '$VERSION';
-            fs.writeFileSync('manifest.json', JSON.stringify(m, null, 2) + '\n');
-          "
-          npx @anthropic-ai/mcpb pack
-          mv gogcli-mcp.mcpb "gogcli-mcp-${VERSION}.mcpb"
-
-      - name: Publish to npm
-        run: npm publish --access public --provenance
-
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v3.0.0
-        with:
-          files: |
-            gogcli-mcp-${{ env.VERSION }}.skill
-            gogcli-mcp-${{ env.VERSION }}.mcpb
-          generate_release_notes: true

package/.github/workflows/tag-and-bump.yml

@@ -1,67 +0,0 @@
-name: Tag & Bump
-
-on:
-  workflow_dispatch:
-
-jobs:
-  ci:
-    uses: ./.github/workflows/ci.yml
-
-  tag-and-bump:
-    needs: ci
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - uses: actions/checkout@v6.0.2
-        with:
-          # PAT required — GITHUB_TOKEN pushes don't trigger other workflows
-          token: ${{ secrets.RELEASE_PAT }}
-
-      - uses: actions/setup-node@v6.3.0
-        with:
-          node-version: 22
-          cache: npm
-
-      - run: npm ci
-
-      - name: Configure git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      # Tag the current commit with the current version
-      - name: Tag current version
-        run: |
-          CURRENT=$(node -p "require('./package.json').version")
-          git tag "v${CURRENT}"
-          echo "TAGGED_VERSION=${CURRENT}" >> "$GITHUB_ENV"
-
-      # Bump patch version in all four locations
-      - name: Bump patch version
-        run: |
-          npm version patch --no-git-tag-version
-          NEXT=$(node -p "require('./package.json').version")
-          echo "NEXT_VERSION=${NEXT}" >> "$GITHUB_ENV"
-
-          # src/index.ts — MCP server version
-          sed -i "s/version: '${TAGGED_VERSION}'/version: '${NEXT}'/" src/index.ts
-
-          # manifest.json
-          node -e "
-            const fs = require('fs');
-            const m = JSON.parse(fs.readFileSync('manifest.json', 'utf8'));
-            m.version = '${NEXT}';
-            fs.writeFileSync('manifest.json', JSON.stringify(m, null, 2) + '\n');
-          "
-
-      - name: Rebuild
-        run: npm run build
-
-      - name: Commit and push
-        run: |
-          git add -A
-          git commit -m "chore: bump version to v${NEXT_VERSION}"
-          git push origin main
-          git push origin "v${TAGGED_VERSION}"

package/.mcp.json

@@ -1,13 +0,0 @@
-{
-  "mcpServers": {
-    "gogcli": {
-      "command": "node",
-      "args": ["dist/index.js"],
-      "cwd": "/Users/chris/git/gogcli-mcp",
-      "env": {
-        "GOG_ACCOUNT": "${GOG_ACCOUNT}",
-        "GOG_PATH": "${GOG_PATH}"
-      }
-    }
-  }
-}

package/CLAUDE.md

@@ -1,61 +0,0 @@
-# gogcli-mcp
-
-MCP server wrapping [gogcli](https://github.com/steipete/gogcli) — provides Claude with read/write access to Google Sheets, with a scaffold for Gmail, Calendar, Drive, and more.
-
-## Build & Test
-
-```bash
-npm run build        # tsc --noEmit (type check) + esbuild bundle → dist/index.js
-npm test             # vitest run (all tests)
-npm run test:watch   # vitest in watch mode
-npm run test:coverage  # vitest with 100% coverage enforcement
-npm run typecheck    # tsc --noEmit only
-```
-
-## Versioning
-
-Version appears in FOUR places — all must match:
-
-1. `package.json` → `"version"`
-2. `package-lock.json` → run `npm install --package-lock-only` after changing package.json
-3. `src/index.ts` → `McpServer` constructor `version` field
-4. `manifest.json` → `"version"`
-
-### Release workflow
-
-Main is always one version ahead of the latest tag. To release, run the **Tag & Bump** GitHub Action (`tag-and-bump.yml`) which:
-
-1. Runs CI (build + test)
-2. Tags the current commit with the current version
-3. Bumps patch in all four files
-4. Rebuilds, commits, and pushes main + tag
-5. The tag push triggers the **Release** workflow (CI + npm publish + .mcpb + .skill + GitHub release)
-
-Do NOT manually bump versions or create tags unless the user explicitly asks. Always prefer the Tag & Bump action: `gh workflow run tag-and-bump.yml --ref main`. The action handles all four version files, tagging, and triggering the release.
-
-## Architecture
-
-- `src/runner.ts` — only module touching `child_process`. Exports `run(args, options)` with `Spawner` DI for testing. Injects `--json --no-input --color=never`, handles `--account` from `options.account` → `GOG_ACCOUNT` env var → omit. 30-second timeout kills stalled processes.
-- `src/tools/sheets.ts` — registers 8 Sheets MCP tools via `registerSheetsTools(server)`. Imports `run()` from runner. Errors are caught and returned as text content so the model can read gogcli's error messages.
-- `src/index.ts` — MCP server entry point. Creates `McpServer`, calls `registerXxxTools(server)` for each service, connects via `StdioServerTransport`.
-- `tests/runner.test.ts` — unit tests for runner using mock `Spawner` DI (no real processes)
-- `tests/tools/sheets.test.ts` — unit tests for sheets tools, runner mocked via `vi.mock`
-
-## Adding a New Google Service
-
-To add Gmail, Calendar, Drive, etc.:
-
-1. Create `src/tools/<service>.ts` — export `registerXxxTools(server: McpServer)`
-2. Implement curated tools for common ops + a `gog_<service>_run` escape hatch (see `sheets.ts` for the pattern)
-3. Create `tests/tools/<service>.test.ts` — mock `runner.run` via `vi.mock('../../src/runner.js')`
-4. In `src/index.ts`, import and call `registerXxxTools(server)`
-5. Add tools to `manifest.json` tools list
-6. No changes to `runner.ts` or `.mcp.json` required
-
-## gogcli Notes
-
-- `gog schema --json` outputs machine-readable command/flag schema for all subcommands
-- `gog sheets update` and `gog sheets append` accept `--values-json=<JSON 2D array>` for structured input
-- All commands support `--account <email>` for multi-account targeting
-- `--no-input` prevents interactive prompts; `--json` ensures parseable output; `--color=never` strips ANSI codes
-- `gog agent exit-codes` documents stable exit codes for automation