[BUG] Composio MCP server stuck on "needs authentication" despite successful browser OAuth
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Environment: Claude Code v2.1.210, Windows, VSCode extension
Steps to reproduce:
claude mcp add --scope user --transport http composio https://connect.composio.dev/mcp
Run /mcp in an interactive terminal session, select composio, choose Reconnect
Browser opens, completes OAuth, shows "Authentication successful — you can close this tab and return to Claude Code"
Return to Claude Code, run claude mcp list
Expected: composio shows as ✔ Connected
Actual: composio continues to show ! Needs authentication, even after:
A full Claude Code restart (twice)
Removing and re-adding the server (claude mcp remove composio + re-add)
Manually clearing the local mcp-needs-auth-cache.json file (confirmed this wasn't a stale-cache issue — the fresh health check re-failed within seconds of clearing it)
Logging into composio.dev directly with the same Google account — no active connection/session appears there at all, suggesting the OAuth callback isn't completing server-side despite the browser showing success
Additional note: This also affected a separate chat session within the same VSCode extension window — a successful auth in one interactive terminal session did not propagate to a parallel chat session, suggesting session-scoped auth state that may not be syncing as expected across the shared ~/.claude.json config.
What Should Happen?
composio shows as ✔ Connected
Error Messages/Logs
Steps to Reproduce
claude mcp add --scope user --transport http composio https://connect.composio.dev/mcp
Run /mcp in an interactive terminal session, select composio, choose Reconnect
Browser opens, completes OAuth, shows "Authentication successful — you can close this tab and return to Claude Code"
Return to Claude Code, run claude mcp list
Claude Model
Sonnet (default)
Is this a regression?
I don't know
Last Working Version
_No response_
Claude Code Version
Version 1.22209.0 (77c938)
Platform
Anthropic API
Operating System
Windows
Terminal/Shell
VS Code integrated terminal
Additional Information
_No response_