szoloth/mcp-troubleshoot
skills/mcp-troubleshoot/SKILL.md
Troubleshoot MCP server connection issues, re-authenticate Gmail MCP, and manage server configurations. This skill should be used when MCP tools fail, servers won't connect, Gmail MCP needs re-authentication, or managing MCP server settings. Triggers on "MCP not working", "Gmail MCP", "MCP error", "server won't connect", or "re-authenticate MCP".
tools
Updated Apr 15, 2026
$ install --global
skillsauthnpx skillsauth add szoloth/skills mcp-troubleshootInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 3:08 AM7.0s1 file scanned
SKILL.md
- name:
- mcp-troubleshoot
- description:
- Troubleshoot MCP server connection issues, re-authenticate Gmail MCP, and manage server configurations. This skill should be used when MCP tools fail, servers won't connect, Gmail MCP needs re-authentication, or managing MCP server settings. Triggers on "MCP not working", "Gmail MCP", "MCP error", "server won't connect", or "re-authenticate MCP".
MCP Troubleshoot
Diagnose and fix MCP server connection issues.
Active Servers Reference
| Server | Tools | Purpose | |--------|-------|---------| | peekaboo | 21 | macOS GUI automation | | things | 22 | Task management | | strava-mcp | 18 | Fitness tracking | | playwright | 22 | Browser automation | | pencil | 20 | Design tool | | google-calendar | 15 | Calendar (personal) | | google-calendar-dreamworks | 15 | Calendar (work) | | gmail | ~10 | Email management |
Gmail MCP Re-authentication
If Gmail MCP fails to connect:
npx @gongrzhe/server-gmail-autoauth-mcp auth
# Then restart Claude Code
Credentials location:
- OAuth config:
~/.gmail-mcp/gcp-oauth.keys.json - Auth tokens:
~/.gmail-mcp/credentials.json
Config in ~/.claude/settings.json:
"gmail": {
"command": "npx",
"args": ["@gongrzhe/server-gmail-autoauth-mcp"]
}
General Troubleshooting
- Server not appearing: Check
~/.claude/settings.jsonfor correct config - Tools timing out: Restart Claude Code to reconnect MCP servers
- Token overhead: Each server adds ~50-200 tokens/tool. Disable unused servers to reduce context cost
Disable/Enable Servers
Edit ~/.claude/settings.json and add/remove server entries from the mcpServers object.
Related Skills
szoloth/youtube-transcript
content-media
VerifiedTrustedCommunity
Fetch transcripts from YouTube videos for summarization and analysis.
SKILL.mdUpdated Apr 15, 2026
szoloth/writing-editor
documentation
VerifiedTrustedCommunity
This skill should be used when reviewing or editing written drafts to ensure they match Sam's personal style guide. It prioritizes voice preservation and anti-beige detection while catching structural gaps. Triggers on requests to review, edit, or improve written content.
SKILL.mdUpdated Apr 15, 2026
szoloth/webapp-testing
tools
VerifiedTrustedCommunity
Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.
SKILL.mdUpdated Apr 15, 2026
szoloth/web-research
development
VerifiedTrustedCommunity
Web search and content extraction using Brave Search. Use when researching topics, finding documentation, extracting article content, or gathering information from the web. No browser required - works headlessly.
SKILL.mdUpdated Apr 15, 2026