neuron-whatsapp
WhatsApp MCP Server & automation platform with 195+ tools for AI chatbots, messaging, contacts, campaigns, knowledge bases, and more.
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeRead-only
What it can do
- Neuron Register: Register a new user account with name, email, password, and organization name. Creates both the user and an initial organization.
- Neuron Login: Authenticate with Neuron. Three modes: 1. No args: Opens a browser URL for secure authorization (recommended — no credentials shared with AI) 2. token: Paste an MCP token from the Neuron
- Neuron Refresh Token: Refresh the access token using a refresh token. Automatically sets the new access token for subsequent API calls.
What data it sees
Do you need an account
No: the server works without sign-in
WhatsApp MCP Server & automation platform with 195+ tools for AI chatbots, messaging, contacts, campaigns, knowledge bases, and more. Supports Claude Code, Cursor, and Windsurf.
How to connect
How to connect neuron-whatsapp to Claude
The server address to paste into Claude settings:
https://neuron-whatsapp.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect neuron-whatsapp to ChatGPT
The server address to paste into ChatGPT settings:
https://neuron-whatsapp.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect neuron-whatsapp to Cursor
The server address to paste into Cursor settings:
https://neuron-whatsapp.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (60)
Raw names from tools/list. Only developers need these.
| neuron_register | Register a new user account with name, email, password, and organization name. Creates both the user and an initial organization. |
| neuron_login | Authenticate with Neuron. Three modes: 1. No args: Opens a browser URL for secure authorization (recommended — no credentials shared with AI) 2. token: Paste an MCP token from the Neuron dashboard 3. email+password: Legacy login (credentials visible to AI) |
| neuron_refresh_token | Refresh the access token using a refresh token. Automatically sets the new access token for subsequent API calls. |
| neuron_switch_org | Switch to a different organization. Returns a new access token scoped to the target organization and automatically sets it. |
| neuron_list_organizations | Retrieve all organizations the authenticated user belongs to, including their roles in each. |
| neuron_get_profile | Retrieve the authenticated user's profile information including name, email, role, and current organization. |
| neuron_whoami | Check which Neuron account is currently logged in, including user name, email, role, and organization. |
| neuron_switch_instance | Switch the MCP server to target a different Neuron backend instance. Auth tokens are preserved per instance — if you've previously logged in to an instance, switching back restores your session automatically. Call with no args to list known instances and see which is active. |
| neuron_logout | Clear the current auth token locally. Does NOT revoke server-side MCP tokens — revoke from the Neuron dashboard (Settings > MCP Tokens) for full invalidation. |
| neuron_create_bot | Create a new AI bot with specified name, model, and behavior instructions. Returns the created bot object. |
| neuron_list_bots | Retrieve all bots accessible to the current user, including their configurations and status. |
| neuron_get_bot | Retrieve detailed information about a specific bot including its configuration, status, and associated resources. |
| neuron_update_bot | Update an existing bot's configuration. Only provided fields are modified; omitted fields remain unchanged. |
| neuron_delete_bot | Permanently delete a bot and all its associated data. This action cannot be undone. |
| neuron_pause_bot | Pause a bot to temporarily stop it from processing new messages. The bot retains its configuration and can be resumed later. |
| neuron_resume_bot | Resume a previously paused bot so it begins processing new messages again. |
| neuron_get_bot_analytics | Retrieve analytics and usage statistics for a specific bot, including message counts, response times, and conversation metrics. |
| neuron_attach_knowledge_base | Attach a knowledge base to a bot to enhance its responses with domain-specific knowledge. Optional priority determines retrieval order when multiple knowledge bases are attached. |
| neuron_list_bot_knowledge_bases | Retrieve all knowledge bases attached to a specific bot, including their priorities and metadata. |
| neuron_detach_knowledge_base | Remove a knowledge base from a bot. The bot will no longer reference this knowledge base when generating responses. |
| neuron_create_api_key | Create a new API key for programmatic access to a specific bot. Store the key securely as it cannot be retrieved later. |
| neuron_list_api_keys | Retrieve all API keys associated with a specific bot, including their names, creation dates, expiration status, and revocation status. |
| neuron_revoke_api_key | Permanently revoke an API key to immediately invalidate it and prevent further programmatic access. This action cannot be undone. |
| neuron_bot_api_chat | Send a message to a bot via the API and receive a streaming or complete AI-generated response. Requires a valid API key with 'nrn_' prefix. |
| neuron_bot_api_send | Send an outbound message through the bot API to a specified phone number. Supports text and media messages. Requires a valid API key. |
| neuron_bot_api_list_conversations | Retrieve a paginated list of conversations managed by the bot. Supports filtering by conversation status. Requires a valid API key. |
| neuron_bot_api_get_messages | Retrieve message history for a specific conversation with cursor-based pagination. Requires a valid API key. |
| neuron_bot_api_get_bot | Retrieve configuration and status information about the bot associated with the provided API key. |
| neuron_list_conversations | Retrieve a paginated list of conversations for a specific bot, with optional filtering by status. |
| neuron_get_conversation | Retrieve detailed information about a specific conversation, including its status, participants, and metadata. |
| neuron_get_messages | Retrieve messages from a specific conversation in chronological order, with optional cursor-based pagination. |
| neuron_takeover_conversation | Transfer control of a conversation from the bot to a human agent. The bot will stop auto-responding until the conversation is released. |
| neuron_release_conversation | Release a conversation back to the bot, returning control from a human agent. The bot will resume auto-responding. |
| neuron_send_message | Send a message to an existing conversation. Supports text, image, and document message types with optional media attachments. |
| neuron_compose_message | Compose and send a new message to a phone number via a specific channel. Automatically creates a new conversation if one does not exist. |
| neuron_send_whatsapp | Send a WhatsApp message to a phone number or group. Auto-resolves which channel to use (org default > first connected). Supports text, image, audio, video, and document types. |
| neuron_edit_message | Edit the content of a previously sent message in a conversation. Only the message sender can edit their messages. |
| neuron_delete_message | Permanently delete a specific message from a conversation. This action cannot be undone. |
| neuron_close_conversation | Close an active conversation, marking it as completed. The bot will stop responding and the conversation is archived. |
| neuron_create_knowledge_base | Create a new knowledge base to store and organize information, documents, and entries. |
| neuron_list_knowledge_bases | Retrieve all knowledge bases accessible to the current user. |
| neuron_get_knowledge_base | Retrieve detailed information about a specific knowledge base by its ID. |
| neuron_update_knowledge_base | Update the properties of an existing knowledge base such as name, description, or root instruction. |
| neuron_delete_knowledge_base | Permanently delete a knowledge base and all its associated entries and documents. |
| neuron_create_kb_entry | Add a new entry (note, document, or information piece) to a knowledge base. |
| neuron_list_kb_entries | Retrieve entries from a knowledge base with optional filtering and pagination. |
| neuron_update_kb_entry | Update the content, title, folder, or source of an existing knowledge base entry. |
| neuron_delete_kb_entry | Permanently delete a specific entry from a knowledge base. |
| neuron_upload_document | Upload a text document to a knowledge base. The document will be automatically chunked and indexed for semantic search. |
| neuron_search_knowledge | Perform semantic search across all entries and documents in a knowledge base to find relevant information. |
| neuron_list_kb_bots | Retrieve all bots that are connected to or using a specific knowledge base. |
| neuron_ingest_knowledge | Ingest content into a knowledge base. Supports deduplication via externalId and optional LLM processing (summarize, extract_facts, or custom instruction). |
| neuron_sync_knowledge | Trigger a synchronization operation to refresh embeddings, reindex content, or update the knowledge base state. |
| neuron_create_tool | Create a custom API tool that the bot can invoke during conversations to fetch external data or trigger actions. |
| neuron_list_tools | Retrieve all custom API tool integrations configured for a specific bot, including their endpoints and configuration. |
| neuron_update_tool | Modify an existing custom API tool's configuration, including its endpoint, authentication, or request template. |
| neuron_delete_tool | Permanently remove a custom API tool integration from a bot. The bot will no longer be able to invoke this tool in conversations. |
| neuron_test_tool | Execute a dry-run test of a custom API tool with sample arguments to verify the endpoint responds correctly. |
| neuron_add_tool_secret | Store or update a secret credential (API key, token, etc.) for a custom tool integration. Secrets are encrypted at rest. |
| neuron_remove_tool_secret | Permanently delete a stored secret from a custom tool integration. The tool will lose access to this credential. |