---
title: Troubleshooting
description: "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…"
url: "https://tecniforge.com/docs/androdiapi-net/androidapi-net-for-claude/troubleshooting/"
updated: "2026-07-02"
category: AndrodiAPI.net / AndroidAPI.net for Claude
---

# 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](https://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](https://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](https://github.com/TecniForge/androidapi-cowork-plugin/releases/latest)
- 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: [ahmad@tecniforge.com](mailto:ahmad@tecniforge.com)

Or open an issue on GitHub: [github.com/TecniForge/androidapi-mcp/issues](https://github.com/TecniForge/androidapi-mcp/issues)

---

### Discover more from TecniForge

Subscribe to get the latest posts sent to your email.
