Troubleshooting

Common issues and solutions when using AndroidAPI.net with Claude.

MCP Connector Issues #

Tools not showing up in Claude Desktop #

Possible causes:

• Claude Desktop was not fully restarted after config change
• claude_desktop_config.json has a JSON syntax error (trailing comma, missing bracket)
• Node.js is not installed or version is below 18

Fix:

1. Quit Claude Desktop completely (Cmd+Q on Mac, not just close window)
2. Validate your JSON at jsonlint.com
3. Check Node version: node --version — must be 18 or higher
4. Reopen Claude Desktop

ANDROIDAPI_SECRET not set error #

The environment variable is missing from the config. Make sure your config looks exactly like this:

{
  "mcpServers": {
    "androidapi": {
      "command": "npx",
      "args": ["-y", "androidapi-mcp"],
      "env": {
        "ANDROIDAPI_SECRET": "your_actual_key_here"
      }
    }
  }
}

Unauthorized or 401 errors #

Your API key is incorrect or expired.

1. Go to androidapi.net → Tools → API Keys
2. Delete the old key and create a new one
3. Update ANDROIDAPI_SECRET in your config
4. Restart Claude Desktop

SMS Issues #

SMS not being sent #

• Check that your device is online and the AndroidAPI app is running
• Verify you are using the correct device ID from androidapi_get_devices
• Make sure the phone number includes the country code (e.g. +923001234567)
• Check your SMS credits: ask Claude “Check my AndroidAPI credits”

Message stuck in pending #

• The device may be offline or in a low-signal area
• Check pending queue: ask Claude “Show my pending SMS messages”
• Restart the AndroidAPI app on the Android device

WhatsApp Issues #

WhatsApp account not linked #

Ask Claude: “Link a new WhatsApp account”. Claude will call androidapi_link_whatsapp_account and return a QR code to scan.

Messages not delivering #

• Verify the recipient has WhatsApp: ask Claude “Check if +923001234567 has WhatsApp”
• Check your account is still connected: ask Claude “List my WhatsApp accounts”
• If disconnected, ask Claude “Relink my WhatsApp account”

Cowork Plugin Issues #

Plugin not installing #

• Make sure you downloaded the .plugin file, not the .zip or source folder
• Download again from the latest release
• Ensure your Claude Cowork app is up to date

Skills not appearing after install #

• Go to Settings → Plugins and verify the plugin shows as Installed
• Go to Settings → Connectors and make sure ANDROIDAPI_SECRET is set
• Restart Claude Cowork

Still Having Issues? #

Contact TecniForge support: [email protected]

Or open an issue on GitHub: github.com/TecniForge/androidapi-mcp/issues