@tiongcreative/assistant-mcp 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.4.0] - 2026-10-19
+
+### Added
+
+- One-command setup, status and removal for ChatGPT desktop on the same Mac. ChatGPT runs the existing local assistant server; app access still depends on each app's assistant setting.
+
 ## [0.3.0] - 2026-10-19
 
 ### Added

package/README.md

@@ -40,6 +40,20 @@ Desktop starts it, so after installing another app restart Claude Desktop once.
 
 To remove it: `npx @tiongcreative/assistant-mcp uninstall`. To check: `npx @tiongcreative/assistant-mcp status`.
 
+### ChatGPT desktop on the same Mac
+
+For ChatGPT desktop, run this one command instead:
+
+```
+npx @tiongcreative/assistant-mcp install chatgpt
+```
+
+It registers the same local server in ChatGPT's MCP settings. Restart ChatGPT, turn on
+**Allow assistant access** in each app, and type `/mcp` in ChatGPT to check the connection.
+The Tiong Creative apps must be open on this Mac. This setup is for ChatGPT desktop, not
+ChatGPT in a web browser. To check or remove it, run `npx @tiongcreative/assistant-mcp status chatgpt`
+or `npx @tiongcreative/assistant-mcp uninstall chatgpt`.
+
 For Claude Code: `claude mcp add tiongcreative -- npx -y @tiongcreative/assistant-mcp`.
 
 ## How it stays on your Mac

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiongcreative/assistant-mcp",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "MCP server that lets an AI assistant on your Mac use your Tiong Creative apps while they are open.",
   "type": "module",
   "bin": {
@@ -34,7 +34,7 @@
     "prepare": "husky",
     "validate": "npm run lint && npm run format:check",
     "quality": "npm run validate && npm run sast && npm run security && npm run secrets && npm run licenses && npm run deps:check && npm run review",
-    "test:unit": "node --test tests/dates.test.js tests/install.test.js",
+    "test:unit": "node --test tests/dates.test.js tests/install.test.js tests/chatgpt-install.test.js",
     "test:integration": "node --test tests/due-again.test.js tests/gift-keeper.test.js tests/client-manager.test.js tests/lists-and-notes.test.js"
   },
   "license": "MIT",

package/src/chatgpt-install.js

@@ -0,0 +1,78 @@
+// ChatGPT desktop and Codex share MCP configuration. Use the CLI shipped with
+// ChatGPT to edit it, so other servers and unrelated settings stay intact.
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { npxPath, SERVER_KEY } from './install.js';
+
+const PACKAGE = '@tiongcreative/assistant-mcp';
+
+function cliPath() {
+  const relative = path.join('Contents', 'Resources', 'codex-cli', 'bin', 'codex');
+  for (const apps of ['/Applications', path.join(os.homedir(), 'Applications')]) {
+    const candidate = path.join(apps, 'ChatGPT.app', relative);
+    if (fs.existsSync(candidate)) return candidate;
+  }
+  throw new Error(
+    'ChatGPT desktop was not found in Applications. Install it before running this command.',
+  );
+}
+
+function run(cli, args) {
+  try {
+    return execFileSync(cli, args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+  } catch (err) {
+    const detail = err.stderr?.toString().trim() || err.message;
+    throw new Error(`ChatGPT could not update its MCP settings: ${detail}`);
+  }
+}
+
+function current(cli) {
+  const servers = JSON.parse(run(cli, ['mcp', 'list', '--json']));
+  if (!Array.isArray(servers)) throw new Error('ChatGPT returned an unexpected MCP server list.');
+  return servers.find((server) => server.name === SERVER_KEY) ?? null;
+}
+
+function matches(server, env) {
+  const transport = server?.transport;
+  return (
+    transport?.type === 'stdio' &&
+    transport.command === npxPath() &&
+    JSON.stringify(transport.args) === JSON.stringify(['-y', PACKAGE]) &&
+    JSON.stringify(transport.env ?? {}) === JSON.stringify(env)
+  );
+}
+
+export function chatGptStatus(cli = cliPath()) {
+  const server = current(cli);
+  return { installed: !!server, managed: matches(server, server?.transport?.env ?? {}) };
+}
+
+export function installChatGpt({ allowFresh = false, cli = cliPath() } = {}) {
+  const env = allowFresh ? { npm_config_min_release_age: '0' } : {};
+  const server = current(cli);
+  if (matches(server, env)) return { already: true };
+  if (server) {
+    throw new Error(
+      'An MCP server named "tiongcreative" already exists in ChatGPT. Remove it in ChatGPT settings before installing this one.',
+    );
+  }
+  const args = ['mcp', 'add'];
+  for (const [key, value] of Object.entries(env)) args.push('--env', `${key}=${value}`);
+  args.push(SERVER_KEY, '--', npxPath(), '-y', PACKAGE);
+  run(cli, args);
+  return { already: false };
+}
+
+export function uninstallChatGpt(cli = cliPath()) {
+  const server = current(cli);
+  if (!server) return { removed: false };
+  if (!matches(server, server.transport?.env ?? {})) {
+    throw new Error(
+      'The "tiongcreative" entry in ChatGPT does not match this package; nothing was removed.',
+    );
+  }
+  run(cli, ['mcp', 'remove', SERVER_KEY]);
+  return { removed: true };
+}

package/src/install.js

@@ -7,6 +7,7 @@
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { chatGptStatus, installChatGpt, uninstallChatGpt } from './chatgpt-install.js';
 
 export const SERVER_KEY = 'tiongcreative';
 const PACKAGE = '@tiongcreative/assistant-mcp';
@@ -109,8 +110,45 @@ const NEXT_STEPS = [
 
 /** Runs the command and returns the process exit code. Prints with the given writer. */
 export function runCli(args, print = console.log) {
-  const [command] = args;
+  const [command, client] = args;
   try {
+    if (client === 'chatgpt' && ['install', 'uninstall', 'status'].includes(command)) {
+      if (command === 'install') {
+        const result = installChatGpt({ allowFresh: args.includes('--allow-fresh') });
+        print(
+          result.already
+            ? 'The Tiong Creative assistant is already set up in ChatGPT.'
+            : 'Added the Tiong Creative assistant to ChatGPT.',
+        );
+        print(
+          '\nNext:\n1. Restart the ChatGPT desktop app.\n2. Open each Tiong Creative app and turn on "Allow assistant access" in Settings.\n3. Type /mcp in ChatGPT to check the connection.',
+        );
+      } else if (command === 'uninstall') {
+        const result = uninstallChatGpt();
+        print(
+          result.removed
+            ? 'Removed the Tiong Creative assistant from ChatGPT. Restart ChatGPT to finish.'
+            : 'The Tiong Creative assistant was not set up in ChatGPT.',
+        );
+      } else {
+        const result = chatGptStatus();
+        print(
+          result.managed
+            ? 'Set up in ChatGPT.'
+            : result.installed
+              ? 'ChatGPT has a different MCP server named "tiongcreative".'
+              : 'Not set up in ChatGPT.',
+        );
+      }
+      return 0;
+    }
+    if (
+      client &&
+      client !== '--allow-fresh' &&
+      ['install', 'uninstall', 'status'].includes(command)
+    ) {
+      throw new Error('Choose "chatgpt" as the client, or omit it for Claude Desktop.');
+    }
     if (command === 'install') {
       const env = {};
       // Developer convenience: `install --allow-fresh` passes npm's release-age override
@@ -146,7 +184,7 @@ export function runCli(args, print = console.log) {
       return 0;
     }
     print(
-      `Usage:\n  npx ${PACKAGE} install     add the assistant to Claude Desktop\n  npx ${PACKAGE} uninstall   remove it\n  npx ${PACKAGE} status      say whether it is set up\n\nWith no command, this runs the MCP server itself (Claude Desktop does that for you).`,
+      `Usage:\n  npx ${PACKAGE} install              add the assistant to Claude Desktop\n  npx ${PACKAGE} install chatgpt      add it to ChatGPT desktop\n  npx ${PACKAGE} uninstall [chatgpt] remove it from the chosen client\n  npx ${PACKAGE} status [chatgpt]    check the chosen client\n\nWith no command, this runs the MCP server itself.`,
     );
     return command === 'help' || command === '--help' ? 0 : 2;
   } catch (err) {