gogcli-mcp-contacts 2.0.6

package/manifest.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/dxt/main/dist/mcpb-manifest.schema.json",
+  "manifest_version": "0.3",
+  "name": "gogcli-mcp-contacts",
+  "display_name": "gogcli (Contacts)",
+  "version": "2.0.6",
+  "description": "Extended Google Contacts for Claude via gogcli — auth + Contacts + Workspace directory (People API)",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com",
+    "url": "https://github.com/chrischall"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrischall/gogcli-mcp"
+  },
+  "homepage": "https://github.com/chrischall/gogcli-mcp",
+  "support": "https://github.com/chrischall/gogcli-mcp/issues",
+  "license": "MIT",
+  "keywords": [
+    "google",
+    "contacts",
+    "people",
+    "directory",
+    "gogcli",
+    "gog"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/dist/index.js"
+      ],
+      "env": {
+        "GOG_ACCOUNT": "${user_config.gog_account}",
+        "GOG_PATH": "${user_config.gog_path}"
+      }
+    }
+  },
+  "user_config": {
+    "gog_account": {
+      "type": "string",
+      "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
+    }
+  },
+  "tools": [
+    {
+      "name": "gog_auth_add",
+      "description": "Authorize a Google account via browser-based OAuth"
+    },
+    {
+      "name": "gog_auth_list",
+      "description": "List all Google accounts stored in gogcli"
+    },
+    {
+      "name": "gog_auth_status",
+      "description": "Show gogcli auth configuration"
+    },
+    {
+      "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_contacts_search",
+      "description": "Search personal contacts by name, email, or phone"
+    },
+    {
+      "name": "gog_contacts_list",
+      "description": "List all personal contacts"
+    },
+    {
+      "name": "gog_contacts_get",
+      "description": "Get a contact by resource name"
+    },
+    {
+      "name": "gog_contacts_create",
+      "description": "Create a new contact"
+    },
+    {
+      "name": "gog_contacts_run",
+      "description": "Run any gog contacts subcommand (escape hatch)"
+    },
+    {
+      "name": "gog_people_me",
+      "description": "Show your own People profile"
+    },
+    {
+      "name": "gog_people_get",
+      "description": "Get a People profile by resource name"
+    },
+    {
+      "name": "gog_people_search",
+      "description": "Search the Workspace directory"
+    },
+    {
+      "name": "gog_people_relations",
+      "description": "Get manager/reports relations for a user"
+    },
+    {
+      "name": "gog_people_raw",
+      "description": "Dump raw People API JSON for a person"
+    }
+  ],
+  "compatibility": {
+    "platforms": [
+      "darwin",
+      "linux",
+      "win32"
+    ],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "gogcli-mcp-contacts",
+  "version": "2.0.6",
+  "mcpName": "io.github.chrischall/gogcli-mcp-contacts",
+  "description": "Extended Google Contacts + People MCP server via gogcli — auth + Contacts + Workspace directory (People API)",
+  "author": "Claude Code (AI) <https://www.anthropic.com/claude>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chrischall/gogcli-mcp"
+  },
+  "type": "module",
+  "bin": {
+    "gogcli-mcp-contacts": "dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc --noEmit && npm run bundle",
+    "bundle": "node ../../scripts/bundle.js src/index.ts dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "google",
+    "gogcli",
+    "contacts",
+    "people",
+    "directory"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer, registerAuthTools, registerContactsTools } from '../../gogcli-mcp/src/lib.js';
+import { registerExtraContactsTools } from './tools/contacts-extra.js';
+
+const server = createServer({ name: 'gogcli-contacts' });
+registerAuthTools(server);
+registerContactsTools(server);
+registerExtraContactsTools(server);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/tools/contacts-extra.ts

@@ -0,0 +1,79 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { accountParam, runOrDiagnose } from '../../../gogcli-mcp/src/lib.js';
+
+export function registerExtraContactsTools(server: McpServer): void {
+  // ─── People API tools ──────────────────────────────────────────
+  // People is the richer API behind Google Contacts: Workspace directory
+  // search, profile fields, and relations.
+
+  server.registerTool('gog_people_me', {
+    description: 'Show your own People profile (people/me).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      account: accountParam,
+    },
+  }, async ({ account }) => {
+    return runOrDiagnose(['people', 'me'], { account });
+  });
+
+  server.registerTool('gog_people_get', {
+    description: 'Get a People profile by resource name.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      userId: z.string().describe('Person resource name (people/...) or email'),
+      account: accountParam,
+    },
+  }, async ({ userId, account }) => {
+    return runOrDiagnose(['people', 'get', userId], { account });
+  });
+
+  server.registerTool('gog_people_search', {
+    description: 'Search the Google Workspace directory (covers internal users, unlike contacts search which is limited to your personal contacts).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      query: z.string().describe('Search query (name, email, etc.)'),
+      max: z.number().optional().describe('Max results (default: 50)'),
+      page: z.string().optional().describe('Page token'),
+      all: z.boolean().optional().describe('Fetch all pages'),
+      account: accountParam,
+    },
+  }, async ({ query, max, page, all, account }) => {
+    const args = ['people', 'search', query];
+    if (max !== undefined) args.push(`--max=${max}`);
+    if (page) args.push(`--page=${page}`);
+    if (all) args.push('--all');
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_people_relations', {
+    description: 'Get relations (manager, reports, etc.) for a user. Defaults to self when userId is omitted.',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      userId: z.string().optional().describe('Person resource name (defaults to self when omitted)'),
+      type: z.string().optional().describe('Filter to a specific relation type (e.g. "manager")'),
+      account: accountParam,
+    },
+  }, async ({ userId, type, account }) => {
+    const args = ['people', 'relations'];
+    if (userId) args.push(userId);
+    if (type) args.push(`--type=${type}`);
+    return runOrDiagnose(args, { account });
+  });
+
+  server.registerTool('gog_people_raw', {
+    description: 'Dump the raw People API response as JSON (lossless; for scripting and LLM consumption).',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      userId: z.string().describe('Person resource name (people/...) or email'),
+      personFields: z.string().optional().describe('People API personFields mask (default: broad set)'),
+      pretty: z.boolean().optional().describe('Pretty-print JSON (default: compact single-line)'),
+      account: accountParam,
+    },
+  }, async ({ userId, personFields, pretty, account }) => {
+    const args = ['people', 'raw', userId];
+    if (personFields) args.push(`--person-fields=${personFields}`);
+    if (pretty) args.push('--pretty');
+    return runOrDiagnose(args, { account });
+  });
+}

package/tests/tools/contacts-extra.test.ts

@@ -0,0 +1,98 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { registerExtraContactsTools } from '../../src/tools/contacts-extra.js';
+import * as lib from '../../../gogcli-mcp/src/lib.js';
+import { setupExtrasHandlers, toText, type ToolHandler } from '../../../gogcli-mcp/tests/helpers/extras-harness.js';
+
+vi.mock('../../../gogcli-mcp/src/lib.js', async (importOriginal) => {
+  const actual = await importOriginal<typeof lib>();
+  return {
+    ...actual,
+    runOrDiagnose: vi.fn(),
+  };
+});
+
+let handlers: Map<string, ToolHandler>;
+
+beforeEach(() => {
+  vi.clearAllMocks();
+  vi.mocked(lib.runOrDiagnose).mockResolvedValue(toText('{}'));
+  handlers = setupExtrasHandlers(registerExtraContactsTools);
+});
+
+describe('gog_people_me', () => {
+  it('calls runOrDiagnose with people me', async () => {
+    await handlers.get('gog_people_me')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'me'], { account: undefined });
+  });
+
+  it('forwards account', async () => {
+    await handlers.get('gog_people_me')!({ account: 'a@b.com' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'me'], { account: 'a@b.com' });
+  });
+});
+
+describe('gog_people_get', () => {
+  it('calls runOrDiagnose with userId', async () => {
+    await handlers.get('gog_people_get')!({ userId: 'people/c123' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'get', 'people/c123'], { account: undefined });
+  });
+});
+
+describe('gog_people_search', () => {
+  it('calls runOrDiagnose with query', async () => {
+    await handlers.get('gog_people_search')!({ query: 'alice' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'search', 'alice'], { account: undefined });
+  });
+
+  it('passes pagination flags', async () => {
+    await handlers.get('gog_people_search')!({ query: 'alice', max: 100, page: 'tok', all: true });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['people', 'search', 'alice', '--max=100', '--page=tok', '--all'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --all when false', async () => {
+    await handlers.get('gog_people_search')!({ query: 'x', all: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'search', 'x'], { account: undefined });
+  });
+});
+
+describe('gog_people_relations', () => {
+  it('calls runOrDiagnose with no userId', async () => {
+    await handlers.get('gog_people_relations')!({});
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'relations'], { account: undefined });
+  });
+
+  it('passes userId and --type when provided', async () => {
+    await handlers.get('gog_people_relations')!({ userId: 'people/c123', type: 'manager' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['people', 'relations', 'people/c123', '--type=manager'],
+      { account: undefined },
+    );
+  });
+});
+
+describe('gog_people_raw', () => {
+  it('calls runOrDiagnose with userId', async () => {
+    await handlers.get('gog_people_raw')!({ userId: 'people/c123' });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'raw', 'people/c123'], { account: undefined });
+  });
+
+  it('passes --person-fields and --pretty when provided', async () => {
+    await handlers.get('gog_people_raw')!({
+      userId: 'people/c123',
+      personFields: 'names,emailAddresses',
+      pretty: true,
+    });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(
+      ['people', 'raw', 'people/c123', '--person-fields=names,emailAddresses', '--pretty'],
+      { account: undefined },
+    );
+  });
+
+  it('omits --pretty when false', async () => {
+    await handlers.get('gog_people_raw')!({ userId: 'people/c123', pretty: false });
+    expect(lib.runOrDiagnose).toHaveBeenCalledWith(['people', 'raw', 'people/c123'], { account: undefined });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "../"
+  },
+  "include": ["src/**/*", "../gogcli-mcp/src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    coverage: {
+      provider: 'v8',
+      include: ['src/**/*.ts'],
+      exclude: ['src/index.ts'],
+      thresholds: {
+        lines: 100,
+        functions: 100,
+        branches: 100,
+        statements: 100,
+      },
+    },
+  },
+});