gogcli-mcp 1.0.0 → 1.0.2

package/manifest.json

@@ -3,7 +3,7 @@
   "manifest_version": "0.3",
   "name": "gogcli-mcp",
   "display_name": "gogcli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Google Sheets (and more) for Claude via gogcli — read, write, and manage spreadsheets",
   "author": {
     "name": "Chris Hall",
@@ -36,7 +36,9 @@
         "${__dirname}/dist/index.js"
       ],
       "env": {
-        "GOG_ACCOUNT": "${user_config.gog_account}"
+        "GOG_ACCOUNT": "${user_config.gog_account}",
+        "GOG_PATH": "${user_config.gog_path}",
+        "GOG_ACCESS_TOKEN": "${user_config.gog_access_token}"
       }
     }
   },
@@ -46,9 +48,194 @@
       "title": "Google Account",
       "description": "Default Google account email (optional — uses gogcli's configured default if omitted)",
       "required": false
+    },
+    "gog_path": {
+      "type": "string",
+      "title": "gog Executable Path",
+      "description": "Path to the gog executable (optional — defaults to 'gog' on your PATH)",
+      "required": false
+    },
+    "gog_access_token": {
+      "type": "string",
+      "title": "Google Access Token",
+      "description": "Short-lived OAuth access token (optional — bypasses stored refresh tokens, expires in ~1h). Useful for CI or automated contexts.",
+      "required": false,
+      "sensitive": true
     }
   },
   "tools": [
+    {
+      "name": "gog_auth_list",
+      "description": "List all Google accounts stored in gogcli"
+    },
+    {
+      "name": "gog_auth_status",
+      "description": "Show gogcli auth configuration (keyring, credential files)"
+    },
+    {
+      "name": "gog_auth_services",
+      "description": "List Google services and OAuth scopes supported by gogcli"
+    },
+    {
+      "name": "gog_auth_run",
+      "description": "Run any gog auth subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_gmail_search",
+      "description": "Search Gmail threads by query"
+    },
+    {
+      "name": "gog_gmail_get",
+      "description": "Get a Gmail message by ID"
+    },
+    {
+      "name": "gog_gmail_send",
+      "description": "Send an email"
+    },
+    {
+      "name": "gog_gmail_run",
+      "description": "Run any gog gmail subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_calendar_events",
+      "description": "List calendar events with optional filters"
+    },
+    {
+      "name": "gog_calendar_get",
+      "description": "Get a specific calendar event"
+    },
+    {
+      "name": "gog_calendar_create",
+      "description": "Create a calendar event"
+    },
+    {
+      "name": "gog_calendar_update",
+      "description": "Update an existing calendar event"
+    },
+    {
+      "name": "gog_calendar_delete",
+      "description": "Delete a calendar event"
+    },
+    {
+      "name": "gog_calendar_respond",
+      "description": "Respond to a calendar event invitation"
+    },
+    {
+      "name": "gog_calendar_run",
+      "description": "Run any gog calendar subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_drive_ls",
+      "description": "List files in a Google Drive folder"
+    },
+    {
+      "name": "gog_drive_search",
+      "description": "Search Google Drive files"
+    },
+    {
+      "name": "gog_drive_get",
+      "description": "Get Google Drive file metadata"
+    },
+    {
+      "name": "gog_drive_mkdir",
+      "description": "Create a folder in Google Drive"
+    },
+    {
+      "name": "gog_drive_rename",
+      "description": "Rename a file or folder in Google Drive"
+    },
+    {
+      "name": "gog_drive_move",
+      "description": "Move a file to a different folder"
+    },
+    {
+      "name": "gog_drive_delete",
+      "description": "Move a file to trash"
+    },
+    {
+      "name": "gog_drive_share",
+      "description": "Share a file or folder"
+    },
+    {
+      "name": "gog_drive_run",
+      "description": "Run any gog drive subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_tasks_lists",
+      "description": "List all Google Task lists"
+    },
+    {
+      "name": "gog_tasks_list",
+      "description": "List tasks in a task list"
+    },
+    {
+      "name": "gog_tasks_get",
+      "description": "Get a specific task"
+    },
+    {
+      "name": "gog_tasks_add",
+      "description": "Add a task to a task list"
+    },
+    {
+      "name": "gog_tasks_done",
+      "description": "Mark a task as completed"
+    },
+    {
+      "name": "gog_tasks_delete",
+      "description": "Delete a task"
+    },
+    {
+      "name": "gog_tasks_run",
+      "description": "Run any gog tasks subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_contacts_search",
+      "description": "Search Google Contacts"
+    },
+    {
+      "name": "gog_contacts_list",
+      "description": "List all Google Contacts"
+    },
+    {
+      "name": "gog_contacts_get",
+      "description": "Get a contact by resource name"
+    },
+    {
+      "name": "gog_contacts_create",
+      "description": "Create a new Google Contact"
+    },
+    {
+      "name": "gog_contacts_run",
+      "description": "Run any gog contacts subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_docs_info",
+      "description": "Get Google Doc metadata (title, ID, properties)"
+    },
+    {
+      "name": "gog_docs_cat",
+      "description": "Read a Google Doc as plain text"
+    },
+    {
+      "name": "gog_docs_create",
+      "description": "Create a new Google Doc"
+    },
+    {
+      "name": "gog_docs_write",
+      "description": "Write or append text content to a Google Doc"
+    },
+    {
+      "name": "gog_docs_find_replace",
+      "description": "Find and replace text in a Google Doc"
+    },
+    {
+      "name": "gog_docs_structure",
+      "description": "Show document structure with numbered paragraphs"
+    },
+    {
+      "name": "gog_docs_run",
+      "description": "Run any gog docs subcommand (escape hatch)"
+    },
     {
       "name": "gog_sheets_get",
       "description": "Read values from a Google Sheets range"

package/package.json

@@ -1,7 +1,11 @@
 {
   "name": "gogcli-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server wrapping gogcli for Google service access",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrischall/gogcli-mcp"
+  },
   "type": "module",
   "bin": {
     "gogcli-mcp": "dist/index.js"

package/src/index.ts

@@ -1,11 +1,25 @@
 #!/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.0' });
+const server = new McpServer({ name: 'gogcli', version: '1.0.2' });
 
+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);

package/src/runner.ts

@@ -26,7 +26,7 @@ export async function run(args: string[], options: RunOptions = {}): Promise<str
   fullArgs.push(...args);
 
   return new Promise((resolve, reject) => {
-    const child = spawner('gog', fullArgs, { env: process.env });
+    const child = spawner(process.env.GOG_PATH ?? 'gog', fullArgs, { env: process.env });
     let stdout = '';
     let stderr = '';
     let settled = false;

package/src/tools/auth.ts

@@ -0,0 +1,57 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { run } from '../runner.js';
+import { toText, toError } from './utils.js';
+
+export function registerAuthTools(server: McpServer): void {
+  server.registerTool('gog_auth_list', {
+    description: 'List all Google accounts stored in gogcli. Use this to check which accounts are configured and available.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {},
+  }, async () => {
+    try {
+      return toText(await run(['auth', 'list']));
+    } catch (err) {
+      return toError(err);
+    }
+  });
+
+  server.registerTool('gog_auth_status', {
+    description: 'Show gogcli auth configuration: keyring backend, credential files, and auth setup.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {},
+  }, async () => {
+    try {
+      return toText(await run(['auth', 'status']));
+    } catch (err) {
+      return toError(err);
+    }
+  });
+
+  server.registerTool('gog_auth_services', {
+    description: 'List all Google services supported by gogcli and the OAuth scopes each requires.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {},
+  }, async () => {
+    try {
+      return toText(await run(['auth', 'services']));
+    } catch (err) {
+      return toError(err);
+    }
+  });
+
+  server.registerTool('gog_auth_run', {
+    description: 'Run any gog auth subcommand. Run `gog auth --help` to see all available subcommands and flags. Note: gog auth add requires interactive browser auth and cannot be completed over MCP — run it in your terminal instead: gog auth add <email> --services <service>',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      subcommand: z.string().describe('The gog auth subcommand, e.g. "remove", "alias", "tokens"'),
+      args: z.array(z.string()).describe('Additional positional args and flags'),
+    },
+  }, async ({ subcommand, args }) => {
+    try {
+      return toText(await run(['auth', subcommand, ...args]));
+    } catch (err) {
+      return toError(err);
+    }
+  });
+}

package/src/tools/calendar.ts

@@ -0,0 +1,128 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { accountParam, runOrDiagnose } from './utils.js';
+
+export function registerCalendarTools(server: McpServer): void {
+  server.registerTool('gog_calendar_events', {
+    description: 'List calendar events. Filters can be combined (e.g. --from + --to for a range, or --today for just today).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      calendarId: z.string().optional().describe('Calendar ID (default: primary calendar)'),
+      from: z.string().optional().describe('Start time filter (RFC3339, date, or natural language)'),
+      to: z.string().optional().describe('End time filter (RFC3339, date, or natural language)'),
+      today: z.boolean().optional().describe('Only show today\'s events'),
+      query: z.string().optional().describe('Free text search within events'),
+      all: z.boolean().optional().describe('Fetch events from all calendars'),
+      account: accountParam,
+    },
+  }, async ({ calendarId, from, to, today, query, all, account }) => {
+    const args = ['calendar', 'events'];
+    if (calendarId) args.push(calendarId);
+    if (from) args.push(`--from=${from}`);
+    if (to) args.push(`--to=${to}`);
+    if (today) args.push('--today');
+    if (query) args.push(`--query=${query}`);
+    if (all) args.push('--all');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_calendar_get', {
+    description: 'Get a specific calendar event by ID.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      calendarId: z.string().describe('Calendar ID'),
+      eventId: z.string().describe('Event ID'),
+      account: accountParam,
+    },
+  }, async ({ calendarId, eventId, account }) => {
+    return runOrDiagnose(['calendar', 'event', calendarId, eventId], { account });
+  });
+
+  server.registerTool('gog_calendar_create', {
+    description: 'Create a calendar event.',
+    annotations: { destructiveHint: false },
+    inputSchema: {
+      calendarId: z.string().describe('Calendar ID (use "primary" for the default calendar)'),
+      summary: z.string().describe('Event title'),
+      from: z.string().describe('Start time (RFC3339 or date for all-day events)'),
+      to: z.string().describe('End time (RFC3339 or date for all-day events)'),
+      description: z.string().optional().describe('Event description'),
+      location: z.string().optional().describe('Event location'),
+      attendees: z.string().optional().describe('Attendee emails, comma-separated'),
+      allDay: z.boolean().optional().describe('All-day event (use date-only in from/to)'),
+      account: accountParam,
+    },
+  }, async ({ calendarId, summary, from, to, description, location, attendees, allDay, account }) => {
+    const args = ['calendar', 'create', calendarId, `--summary=${summary}`, `--from=${from}`, `--to=${to}`];
+    if (description) args.push(`--description=${description}`);
+    if (location) args.push(`--location=${location}`);
+    if (attendees) args.push(`--attendees=${attendees}`);
+    if (allDay) args.push('--all-day');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_calendar_update', {
+    description: 'Update an existing calendar event.',
+    annotations: { destructiveHint: false },
+    inputSchema: {
+      calendarId: z.string().describe('Calendar ID'),
+      eventId: z.string().describe('Event ID'),
+      summary: z.string().optional().describe('New event title'),
+      from: z.string().optional().describe('New start time (RFC3339)'),
+      to: z.string().optional().describe('New end time (RFC3339)'),
+      description: z.string().optional().describe('New description'),
+      location: z.string().optional().describe('New location'),
+      attendees: z.string().optional().describe('New attendee emails, comma-separated (replaces existing)'),
+      account: accountParam,
+    },
+  }, async ({ calendarId, eventId, summary, from, to, description, location, attendees, account }) => {
+    const args = ['calendar', 'update', calendarId, eventId];
+    if (summary !== undefined) args.push(`--summary=${summary}`);
+    if (from !== undefined) args.push(`--from=${from}`);
+    if (to !== undefined) args.push(`--to=${to}`);
+    if (description !== undefined) args.push(`--description=${description}`);
+    if (location !== undefined) args.push(`--location=${location}`);
+    if (attendees !== undefined) args.push(`--attendees=${attendees}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_calendar_delete', {
+    description: 'Delete a calendar event.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      calendarId: z.string().describe('Calendar ID'),
+      eventId: z.string().describe('Event ID'),
+      account: accountParam,
+    },
+  }, async ({ calendarId, eventId, account }) => {
+    return runOrDiagnose(['calendar', 'delete', calendarId, eventId], { account });
+  });
+
+  server.registerTool('gog_calendar_respond', {
+    description: 'Respond to a calendar event invitation.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      calendarId: z.string().describe('Calendar ID'),
+      eventId: z.string().describe('Event ID'),
+      status: z.enum(['accepted', 'declined', 'tentative']).describe('Response status'),
+      comment: z.string().optional().describe('Optional comment to include with response'),
+      account: accountParam,
+    },
+  }, async ({ calendarId, eventId, status, comment, account }) => {
+    const args = ['calendar', 'respond', calendarId, eventId, `--status=${status}`];
+    if (comment) args.push(`--comment=${comment}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_calendar_run', {
+    description: 'Run any gog calendar subcommand not covered by the other tools. Run `gog calendar --help` for the full list of subcommands, or `gog calendar <subcommand> --help` for flags on a specific subcommand.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      subcommand: z.string().describe('The gog calendar subcommand to run, e.g. "calendars", "freebusy"'),
+      args: z.array(z.string()).describe('Additional positional args and flags'),
+      account: accountParam,
+    },
+  }, async ({ subcommand, args, account }) => {
+    return runOrDiagnose(['calendar', subcommand, ...args], { account });
+  });
+}

package/src/tools/contacts.ts

@@ -0,0 +1,71 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { accountParam, runOrDiagnose } from './utils.js';
+
+export function registerContactsTools(server: McpServer): void {
+  server.registerTool('gog_contacts_search', {
+    description: 'Search Google Contacts by name, email, or phone.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: z.string().describe('Search query (name, email, or phone)'),
+      account: accountParam,
+    },
+  }, async ({ query, account }) => {
+    return runOrDiagnose(['contacts', 'search', query], { account });
+  });
+
+  server.registerTool('gog_contacts_list', {
+    description: 'List all Google Contacts.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      account: accountParam,
+    },
+  }, async ({ account }) => {
+    return runOrDiagnose(['contacts', 'list'], { account });
+  });
+
+  server.registerTool('gog_contacts_get', {
+    description: 'Get a contact by resource name.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      resourceName: z.string().describe('Contact resource name (e.g. people/c12345)'),
+      account: accountParam,
+    },
+  }, async ({ resourceName, account }) => {
+    return runOrDiagnose(['contacts', 'get', resourceName], { account });
+  });
+
+  server.registerTool('gog_contacts_create', {
+    description: 'Create a new Google Contact.',
+    annotations: { destructiveHint: false },
+    inputSchema: {
+      givenName: z.string().describe('Given (first) name'),
+      familyName: z.string().optional().describe('Family (last) name'),
+      email: z.string().optional().describe('Email address'),
+      phone: z.string().optional().describe('Phone number'),
+      org: z.string().optional().describe('Organization/company name'),
+      title: z.string().optional().describe('Job title'),
+      account: accountParam,
+    },
+  }, async ({ givenName, familyName, email, phone, org, title, account }) => {
+    const args = ['contacts', 'create', `--given=${givenName}`];
+    if (familyName) args.push(`--family=${familyName}`);
+    if (email) args.push(`--email=${email}`);
+    if (phone) args.push(`--phone=${phone}`);
+    if (org) args.push(`--org=${org}`);
+    if (title) args.push(`--title=${title}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_contacts_run', {
+    description: 'Run any gog contacts subcommand not covered by the other tools. Run `gog contacts --help` for the full list of subcommands, or `gog contacts <subcommand> --help` for flags on a specific subcommand.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      subcommand: z.string().describe('The gog contacts subcommand to run, e.g. "update", "delete", "directory"'),
+      args: z.array(z.string()).describe('Additional positional args and flags'),
+      account: accountParam,
+    },
+  }, async ({ subcommand, args, account }) => {
+    return runOrDiagnose(['contacts', subcommand, ...args], { account });
+  });
+}

package/src/tools/docs.ts

@@ -0,0 +1,89 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { accountParam, runOrDiagnose } from './utils.js';
+
+export function registerDocsTools(server: McpServer): void {
+  server.registerTool('gog_docs_info', {
+    description: 'Get Google Doc metadata: title, ID, and other properties.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      account: accountParam,
+    },
+  }, async ({ docId, account }) => {
+    return runOrDiagnose(['docs', 'info', docId], { account });
+  });
+
+  server.registerTool('gog_docs_cat', {
+    description: 'Read a Google Doc as plain text.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      account: accountParam,
+    },
+  }, async ({ docId, account }) => {
+    return runOrDiagnose(['docs', 'cat', docId], { account });
+  });
+
+  server.registerTool('gog_docs_create', {
+    description: 'Create a new Google Doc. Returns JSON with the new docId and URL.',
+    annotations: { destructiveHint: false },
+    inputSchema: {
+      title: z.string().describe('Title for the new document'),
+      account: accountParam,
+    },
+  }, async ({ title, account }) => {
+    return runOrDiagnose(['docs', 'create', title], { account });
+  });
+
+  server.registerTool('gog_docs_write', {
+    description: 'Write text content to a Google Doc, replacing existing body content by default. Set append=true to add after existing content.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      text: z.string().describe('Text content to write'),
+      append: z.boolean().optional().describe('Append to existing content instead of replacing (default: false)'),
+      account: accountParam,
+    },
+  }, async ({ docId, text, append, account }) => {
+    const args = ['docs', 'write', docId, `--text=${text}`];
+    if (append) args.push('--append');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_docs_find_replace', {
+    description: 'Find and replace text in a Google Doc.',
+    annotations: { destructiveHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      find: z.string().describe('Text to find'),
+      replace: z.string().describe('Replacement text'),
+      account: accountParam,
+    },
+  }, async ({ docId, find, replace, account }) => {
+    return runOrDiagnose(['docs', 'find-replace', docId, find, replace], { account });
+  });
+
+  server.registerTool('gog_docs_structure', {
+    description: 'Show a Google Doc\'s structure with numbered paragraphs. Useful for understanding the document layout before making index-based edits.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      docId: z.string().describe('Doc ID (from the URL)'),
+      account: accountParam,
+    },
+  }, async ({ docId, account }) => {
+    return runOrDiagnose(['docs', 'structure', docId], { 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 },
+    inputSchema: {
+      subcommand: z.string().describe('The gog docs subcommand to run, e.g. "copy", "clear", "insert", "sed", "export"'),
+      args: z.array(z.string()).describe('Additional positional args and flags'),
+      account: accountParam,
+    },
+  }, async ({ subcommand, args, account }) => {
+    return runOrDiagnose(['docs', subcommand, ...args], { account });
+  });
+}