get-claudia 1.53.1 → 1.53.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to Claudia will be documented in this file.
 
+## 1.53.2 (2026-03-04)
+
+### Re-enable Gmail and Calendar MCPs
+
+Gmail and Calendar MCP servers were disabled in v1.53.1 as a workaround for Claude Code bug #17962 (multiple stdio servers). Multiple stdio servers now work reliably, so these are re-enabled.
+
+- **Gmail and Calendar enabled by default** -- `.mcp.json.example` ships `gmail` and `google-calendar` as active entries (no `_disabled_` prefix). Both require Google Cloud credentials (see Google Integration Setup in CLAUDE.md).
+- **Restore function re-enables Gmail/Calendar** -- `restoreMcpServers()` now also restores `gmail` and `google-calendar` from `_disabled_mcpServers` on upgrade. Additionally handles `_disabled_`-prefixed keys in `mcpServers` itself.
+- **Diagnose skill updated** -- Removed multiple-stdio warning (Step 1b) and the advice to disable Gmail/Calendar. Step 1b now simply lists active servers without warning about conflicts.
+- **Removed stdio_warning from config notes** -- `.mcp.json.example` no longer warns about multiple stdio servers or suggests disabling Gmail/Calendar.
+
 ## 1.53.1 (2026-03-04)
 
 ### The One-Stdio Fix: Memory Tools Actually Connect

package/bin/index.js

@@ -775,7 +775,6 @@ async function main() {
     // Configure .mcp.json with correct daemon path
     if (daemonOk) {
       ensureDaemonMcpConfig(targetPath, venvPython);
-      warnMultipleStdioServers(targetPath);
     }
 
     // Run preflight check to verify daemon can actually start
@@ -973,7 +972,6 @@ async function main() {
       { name: 'Personality & Skills', ok: true },
       { name: 'Memory Daemon', ok: memoryInstalled },
       { name: 'MCP Config', ok: mcpCheck.hasDaemon },
-      { name: 'Stdio Servers', ok: mcpCheck.stdioCount <= 1, warn: mcpCheck.stdioCount > 1 ? `${mcpCheck.stdioCount} active (only 1 reliable)` : null },
     ];
 
     console.log(` ${colors.bold}Components:${colors.reset}`);
@@ -1006,8 +1004,8 @@ async function main() {
  * Restore MCP servers that were moved to _disabled_mcpServers by earlier versions.
  * - claudia-memory: v1.51.13+ treated the daemon as legacy (replaced by CLI),
  *   but MCP is the primary memory interface as of v1.51.22.
- * - Gmail/Calendar are NOT restored: Claude Code bug #17962 means multiple stdio
- *   servers silently fail. Users should use Rube (HTTP) instead.
+ * - Gmail/Calendar: v1.53.1 disabled these due to Claude Code bug #17962,
+ *   but multiple stdio servers now work reliably. Restore them.
  */
 function restoreMcpServers(targetPath) {
   const mcpPath = join(targetPath, '.mcp.json');
@@ -1019,8 +1017,8 @@ function restoreMcpServers(targetPath) {
     if (!config._disabled_mcpServers) return;
     if (!config.mcpServers) config.mcpServers = {};
 
-    // Only restore claudia-memory, not gmail/google-calendar (multiple stdio bug #17962)
-    const toRestore = ['claudia-memory', 'claudia_memory'];
+    // Restore all previously disabled servers (memory, gmail, google-calendar)
+    const toRestore = ['claudia-memory', 'claudia_memory', 'gmail', 'google-calendar'];
     let changed = false;
     const restored = [];
 
@@ -1028,6 +1026,7 @@ function restoreMcpServers(targetPath) {
       if (config._disabled_mcpServers[key] && !config.mcpServers[key]) {
         const serverConfig = { ...config._disabled_mcpServers[key] };
         delete serverConfig._replaced_by;
+        delete serverConfig._warning;
         config.mcpServers[key] = serverConfig;
         delete config._disabled_mcpServers[key];
         changed = true;
@@ -1035,6 +1034,21 @@ function restoreMcpServers(targetPath) {
       }
     }
 
+    // Also rename _disabled_ prefixed keys in mcpServers itself
+    for (const key of Object.keys(config.mcpServers)) {
+      if (key.startsWith('_disabled_')) {
+        const realKey = key.replace('_disabled_', '');
+        if (['gmail', 'google-calendar'].includes(realKey) && !config.mcpServers[realKey]) {
+          const serverConfig = { ...config.mcpServers[key] };
+          delete serverConfig._warning;
+          config.mcpServers[realKey] = serverConfig;
+          delete config.mcpServers[key];
+          changed = true;
+          restored.push(realKey);
+        }
+      }
+    }
+
     // Clean up _disabled_mcpServers if it's now empty
     if (config._disabled_mcpServers && Object.keys(config._disabled_mcpServers).length === 0) {
       delete config._disabled_mcpServers;
@@ -1113,29 +1127,6 @@ function checkMcpConfig(targetPath) {
   }
 }
 
-/**
- * Warn if multiple stdio MCP servers are active in .mcp.json.
- * Claude Code bug #17962: only one stdio server connects reliably.
- */
-function warnMultipleStdioServers(targetPath) {
-  const mcpPath = join(targetPath, '.mcp.json');
-  if (!existsSync(mcpPath)) return;
-  try {
-    const config = JSON.parse(readFileSync(mcpPath, 'utf-8'));
-    const servers = config.mcpServers || {};
-    const stdioServers = Object.entries(servers)
-      .filter(([key]) => !key.startsWith('_disabled') && !key.startsWith('_'))
-      .filter(([, val]) => !val._disabled && (!val.type || val.type === 'stdio'))
-      .map(([key]) => key);
-
-    if (stdioServers.length > 1) {
-      console.log('');
-      console.log(`  ${colors.boldYellow}⚠ Warning:${colors.reset} ${stdioServers.length} stdio MCP servers detected: ${stdioServers.join(', ')}`);
-      console.log(`  ${colors.dim}Claude Code can only reliably connect to one stdio server at a time (bug #17962).${colors.reset}`);
-      console.log(`  ${colors.dim}claudia-memory should be the only stdio server. Use Rube (HTTP) for Gmail/Calendar.${colors.reset}`);
-    }
-  } catch { /* ignore parse errors */ }
-}
 
 /**
  * Register (or update) the macOS LaunchAgent for the standalone daemon.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.53.1",
+  "version": "1.53.2",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",

package/template-v2/.claude/skills/diagnose/SKILL.md

@@ -36,27 +36,24 @@ If the Python binary in the `command` field doesn't exist:
 ls -la ~/.claudia/daemon/venv/bin/python 2>/dev/null || echo "Daemon venv not found"
 ```
 
-### Step 1b: Check for Multiple Stdio Servers
+### Step 1b: Check Active MCP Servers
 
-Claude Code has a known bug (#17962) where multiple stdio MCP servers silently fail to connect.
-Count the active stdio servers (entries without `_disabled` prefix and without `type: "http"`):
+List all active MCP servers (entries without `_disabled` prefix):
 
 ```bash
 python3 -c "
 import json
 c = json.load(open('.mcp.json'))
 servers = c.get('mcpServers', {})
-stdio = [k for k, v in servers.items()
-         if not k.startswith('_') and v.get('type', 'stdio') == 'stdio']
-print(f'Active stdio servers ({len(stdio)}): {chr(44).join(stdio)}')
-if len(stdio) > 1:
-    print('WARNING: Multiple stdio servers detected. Only one is reliable.')
-    print('Keep claudia-memory, disable others or move them to Rube (HTTP).')
+active = [k for k, v in servers.items() if not k.startswith('_')]
+stdio = [k for k in active if servers[k].get('type', 'stdio') == 'stdio']
+http = [k for k in active if servers[k].get('type') == 'http']
+print(f'Active servers ({len(active)}): {chr(44).join(active)}')
+print(f'  stdio: {chr(44).join(stdio) or \"none\"}')
+print(f'  http: {chr(44).join(http) or \"none\"}')
 "
 ```
 
-If multiple stdio servers are detected, this is very likely the cause of missing tools. Fix by disabling extras (see Common Issues below).
-
 ### Step 2: Run Preflight Check
 
 The daemon has a built-in preflight validator that tests all 11 startup steps:
@@ -129,7 +126,7 @@ Format the diagnosis as:
 | Component | Status | Details |
 |-----------|--------|---------|
 | .mcp.json config | ✅/❌ | [daemon entry present/missing] |
-| Stdio server count | ✅/⚠️ | [1 = good / >1 = likely cause of issues] |
+| Active MCP servers | ✅/⚠️ | [list of active servers] |
 | Daemon Python binary | ✅/❌ | [path exists/missing] |
 | Preflight | ✅/❌ | [all passed / N failures] |
 | Session manifest | ✅/❌ | [running/died/never started] |
@@ -159,21 +156,11 @@ If preflight shows fixable issues, try auto-repair:
 ~/.claudia/daemon/venv/bin/python -m claudia_memory --repair --project-dir "$PWD"
 ```
 
-### Issue: Multiple stdio MCP servers (most common cause of missing tools)
-
-**Cause:** Claude Code bug #17962 means only one stdio server connects reliably. If `.mcp.json` has `claudia-memory`, `gmail`, and `google-calendar` all active as stdio servers, the daemon's tools silently vanish.
-
-**Fix:** Disable all stdio servers except `claudia-memory`. Prefix their keys with `_disabled_`:
-- `"gmail"` → `"_disabled_gmail"`
-- `"google-calendar"` → `"_disabled_google-calendar"`
-
-For Gmail/Calendar, use Rube (HTTP transport at `https://mcp.composio.dev`) instead of individual stdio servers. See the Rube section in CLAUDE.md.
-
 ### Issue: Tools not in palette but no error
 
-**Cause:** Daemon started but exited before Claude Code could handshake, Claude Code closed stdin too early, or multiple stdio servers are conflicting (check Step 1b above).
+**Cause:** Daemon started but exited before Claude Code could handshake, or Claude Code closed stdin too early.
 
-**Fix:** First check for multiple stdio servers (Step 1b). If that's not the issue, check the session manifest:
+**Fix:** Check the session manifest:
 ```bash
 cat ~/.claudia/daemon-session.json
 ```

package/template-v2/.mcp.json.example

@@ -6,17 +6,15 @@
       "_description": "Claudia memory system with vector search",
       "_setup": "Auto-configured by the installer (npx get-claudia). The installer creates a Python venv at ~/.claudia/daemon/venv/ and sets the correct command path in .mcp.json automatically."
     },
-    "_disabled_gmail": {
+    "gmail": {
       "command": "npx",
       "args": ["-y", "@gongrzhe/server-gmail-autoauth-mcp"],
-      "_setup": "Requires your own Google Cloud credentials. See Google Integration Setup in CLAUDE.md, then run: npx @gongrzhe/server-gmail-autoauth-mcp auth",
-      "_warning": "Enabling this adds a second stdio server. Claude Code bug #17962 may cause silent failures with multiple stdio servers. Consider using Rube (HTTP) for Gmail instead."
+      "_setup": "Requires your own Google Cloud credentials. See Google Integration Setup in CLAUDE.md, then run: npx @gongrzhe/server-gmail-autoauth-mcp auth"
     },
-    "_disabled_google-calendar": {
+    "google-calendar": {
       "command": "npx",
       "args": ["-y", "@gongrzhe/server-calendar-autoauth-mcp"],
-      "_setup": "Requires your own Google Cloud credentials. See Google Integration Setup in CLAUDE.md, then run: npx @gongrzhe/server-calendar-autoauth-mcp auth",
-      "_warning": "Enabling this adds a second stdio server. Claude Code bug #17962 may cause silent failures with multiple stdio servers. Consider using Rube (HTTP) for Gmail/Calendar instead."
+      "_setup": "Requires your own Google Cloud credentials. See Google Integration Setup in CLAUDE.md, then run: npx @gongrzhe/server-calendar-autoauth-mcp auth"
     },
     "rube": {
       "type": "http",
@@ -30,16 +28,15 @@
   },
 
   "_notes": {
-    "stdio_warning": "Claude Code can only reliably connect to ONE stdio MCP server at a time (bug #17962). claudia-memory is the essential one. For Gmail/Calendar, use Rube (HTTP) instead of enabling individual stdio servers.",
     "memory": "Claudia's memory is powered by the claudia-memory daemon (Python MCP server). It provides ~33 tools for semantic search, pattern detection, and relationship tracking. The installer (npx get-claudia) automatically sets up the daemon in a Python venv at ~/.claudia/daemon/venv/ and configures .mcp.json.",
-    "gmail_and_calendar": "Gmail and Calendar are disabled by default to avoid the multiple-stdio bug. To use them: either enable them individually (rename _disabled_gmail to gmail) knowing only one stdio server is reliable, or connect them through Rube (HTTP, no conflict).",
-    "rube": "Rube (by Composio) connects 500+ apps through one HTTP MCP connection. No stdio conflict. Each user creates their own free Rube account at rube.app. See the Rube section in CLAUDE.md for setup and troubleshooting.",
+    "gmail_and_calendar": "Gmail and Calendar are enabled by default as stdio MCP servers. Each requires Google Cloud credentials (see Google Integration Setup in CLAUDE.md). Alternatively, connect them through Rube (HTTP) for a simpler setup.",
+    "rube": "Rube (by Composio) connects 500+ apps through one HTTP MCP connection. Each user creates their own free Rube account at rube.app. See the Rube section in CLAUDE.md for setup and troubleshooting.",
     "security": "Each user authenticates with their own accounts and credentials. OAuth tokens are stored locally on your machine, never shared.",
     "not_included": {
       "filesystem": "Claude Code has native Read/Write/Edit tools",
       "web-search": "Claude Code has native WebSearch",
       "fetch": "Claude Code has native WebFetch"
     },
-    "adding_servers": "Add MCP servers here if needed. Find more at mcp.so or github.com/modelcontextprotocol/servers. Be aware that adding stdio servers alongside claudia-memory may cause connection issues."
+    "adding_servers": "Add MCP servers here if needed. Find more at mcp.so or github.com/modelcontextprotocol/servers."
   }
 }