We and selected third parties use cookies or similar technologies for technical purposes and, with your consent, to analyze how the site is used.

You can freely give, refuse or withdraw your consent at any time.

GREEN-API WhatsApp

MCP server by GREEN-API

Send WhatsApp messages, manage groups and contacts, and administer GREEN-API instances from an AI assistant.

Needs an API key (Needs an API key from the vendor)Streamable HTTP

Connect to GREEN-API WhatsApp

GREEN-API WhatsApp needs an API key. Connect with its own URL and your key:

https://mcp.green-api.com/mcp

Send your key in the X-Instance-Id header. mcp.tc never sees or stores keys. Where to get a key

Share this server

Opens this page, with the URL and setup steps.

mcp.tc/i/green-api-whatsapp

About

Connects an assistant to WhatsApp through GREEN-API. It can send text, files, locations, contacts and polls, edit, forward and delete messages, read chat history and recent messages, manage groups, check whether numbers have WhatsApp, and manage instances, including the Partner API for creating and deleting them.

Runs as a hosted streamable HTTP endpoint (with a legacy SSE endpoint), or as a local Go binary over stdio. The hosted endpoint takes a GREEN-API instance ID and instance token as the X-Instance-Id and X-Api-Token headers. The README also mentions a built-in OAuth flow in proxy mode.

What you can do

  • Send text, files, locations, contacts and polls
  • Edit, forward and delete messages
  • Read chat history and recent incoming or outgoing messages
  • Create groups and manage participants and admins
  • Check whether phone numbers have WhatsApp
  • View and update instance settings, state and QR code
  • Create, list and delete partner instances

Tools 41

  • whatsapp_add_group_participantWrites

    Add a participant to a WhatsApp group

  • whatsapp_check_whatsappRead-only

    Check whether a phone number has a WhatsApp account

  • whatsapp_connectWrites

    Connect a WhatsApp instance and validate credentials

  • whatsapp_create_groupWrites

    Create a WhatsApp group

  • whatsapp_create_instanceWrites

    Create a new instance via the Partner API

  • whatsapp_delete_instanceCan delete

    Delete an instance via the Partner API

  • whatsapp_delete_messageCan delete

    Delete a message

  • whatsapp_delete_notificationCan delete

    Delete a notification from the queue

  • whatsapp_disconnectWrites

    Disconnect an instance and remove its credentials from the session

  • whatsapp_edit_messageCan delete

    Edit a previously sent message

  • whatsapp_forward_messagesCan delete

    Forward messages to another chat

  • whatsapp_get_authorization_codeRead-only

    Get an authorization code for sign-in by phone number

Show 29 more tools
  • whatsapp_get_chat_historyRead-only

    Get chat message history

  • whatsapp_get_contact_avatarRead-only

    Get the avatar of a contact or group

  • whatsapp_get_contact_infoRead-only

    Get information about a contact or group

  • whatsapp_get_contactsRead-only

    Get the contact list

  • whatsapp_get_group_dataRead-only

    Get group members, name and invite link

  • whatsapp_get_instancesRead-only

    List partner instances

  • whatsapp_get_messageRead-only

    Get a message by ID

  • whatsapp_get_qrRead-only

    Get the QR code for instance authorization

  • whatsapp_get_settingsRead-only

    Get instance settings

  • whatsapp_get_stateRead-only

    Get instance state such as authorized or blocked

  • whatsapp_get_wa_settingsRead-only

    Get WhatsApp account settings

  • whatsapp_last_incoming_messagesRead-only

    Get incoming messages from the last N minutes

  • whatsapp_last_outgoing_messagesRead-only

    Get outgoing messages from the last N minutes

  • whatsapp_leave_groupCan delete

    Leave a WhatsApp group

  • whatsapp_logoutCan delete

    Log out the WhatsApp instance

  • whatsapp_read_chatWrites

    Mark chat messages as read

  • whatsapp_rebootWrites

    Reboot the WhatsApp instance

  • whatsapp_receive_notificationRead-only

    Get one notification from the queue by polling

  • whatsapp_remove_group_adminCan delete

    Revoke admin rights from a group member

  • whatsapp_remove_group_participantCan delete

    Remove a participant from a group

  • whatsapp_send_contactCan delete

    Send a contact card

  • whatsapp_send_fileCan delete

    Send a file by URL

  • whatsapp_send_file_by_uploadCan delete

    Send a file directly via multipart upload

  • whatsapp_send_locationCan delete

    Send a location

  • whatsapp_send_messageCan delete

    Send a text message

  • whatsapp_send_pollCan delete

    Send a poll

  • whatsapp_set_group_adminWrites

    Promote a group member to admin

  • whatsapp_set_settingsCan delete

    Update instance settings such as webhooks

  • whatsapp_upload_fileWrites

    Upload File

Read from the live server on 18 Nov 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.

Example prompts

  • Send a WhatsApp message to 15551234567 saying the order has shipped

  • Show messages received in the last 2 hours

  • Create a WhatsApp group called Project Team with these numbers

  • Check whether +49 170 1234567 is on WhatsApp

Set up

Every client connects to mcp.green-api.com. Pick yours; the page remembers your choice.

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport http green-api-whatsapp https://mcp.green-api.com/mcp --header "X-Instance-Id: <YOUR_X_INSTANCE_ID>" --header "X-Api-Token: <YOUR_X_API_TOKEN>"
  1. Replace the placeholder with your key before you run it, then check it with /mcp inside Claude Code.

Add --scope user to make it available in every project, not just this one.

Claude Desktop

  1. Use the mcp-remote bridge, which keeps the key on this computer (a connector added on claude.ai with the key under Request headers also shows up here). Open Settings → Developer → Edit Config and add:
claude_desktop_config.json
{
  "mcpServers": {
    "green-api-whatsapp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.green-api.com/mcp",
        "--header",
        "X-Instance-Id: <YOUR_X_INSTANCE_ID>",
        "--header",
        "X-Api-Token: <YOUR_X_API_TOKEN>"
      ]
    }
  }
}
  1. Replace the placeholder with your key and restart Claude Desktop.

The bridge needs Node.js on your computer.

claude.ai

  1. Open the connector form on claude.ai. This button fills in the name and URL for you:
  1. Check that the URL reads https://mcp.green-api.com/mcp. Under Request headers, add X-Instance-Id: <YOUR_X_INSTANCE_ID> and X-Api-Token: <YOUR_X_API_TOKEN> with your key from GREEN-API, then click Add.
  2. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under Organization settings → Connectors.

Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "green-api-whatsapp": {
      "url": "https://mcp.green-api.com/mcp",
      "headers": {
        "X-Instance-Id": "<YOUR_X_INSTANCE_ID>",
        "X-Api-Token": "<YOUR_X_API_TOKEN>"
      }
    }
  }
}

VS Code

Add it to .vscode/mcp.json. VS Code asks for the key the first time and stores it securely:

.vscode/mcp.json
{
  "servers": {
    "green-api-whatsapp": {
      "type": "http",
      "url": "https://mcp.green-api.com/mcp",
      "headers": {
        "X-Instance-Id": "${input:x-instance-id}",
        "X-Api-Token": "${input:x-api-token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "x-instance-id",
      "description": "X-Instance-Id",
      "password": true
    },
    {
      "type": "promptString",
      "id": "x-api-token",
      "description": "X-Api-Token",
      "password": true
    }
  ]
}

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "green-api-whatsapp": {
      "serverUrl": "https://mcp.green-api.com/mcp",
      "headers": {
        "X-Instance-Id": "<YOUR_X_INSTANCE_ID>",
        "X-Api-Token": "<YOUR_X_API_TOKEN>"
      }
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads serverUrl (or url) for remote servers.

Codex

codex mcp add green-api-whatsapp --url https://mcp.green-api.com/mcp

codex mcp add can’t set the X-Instance-Id and X-Api-Token headers, so this step is required: put this entry in ~/.codex/config.toml instead of running the command, or add its env_http_headers line to the entry the command made:

config.toml
[mcp_servers.green-api-whatsapp]
url = "https://mcp.green-api.com/mcp"
env_http_headers = { "X-Instance-Id" = "X_INSTANCE_ID", "X-Api-Token" = "X_API_TOKEN" }

Codex reads the header values from the environment variables named in env_http_headers.

Gemini CLI

gemini mcp add --transport http --header "X-Instance-Id: <YOUR_X_INSTANCE_ID>" --header "X-Api-Token: <YOUR_X_API_TOKEN>" green-api-whatsapp https://mcp.green-api.com/mcp

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients accept this shape. Some name the URL field differently: serverUrl in Devin Desktop, httpUrl in Gemini CLI’s settings file.

{
  "mcpServers": {
    "green-api-whatsapp": {
      "type": "http",
      "url": "https://mcp.green-api.com/mcp",
      "headers": {
        "X-Instance-Id": "<YOUR_X_INSTANCE_ID>",
        "X-Api-Token": "<YOUR_X_API_TOKEN>"
      }
    }
  }
}

Zed puts servers under context_servers in its settings. Cline needs "type": "streamableHttp", or it assumes SSE.

Client only starts local servers? Bridge it with npx -y mcp-remote https://mcp.green-api.com/mcp.

Embed

Show GREEN-API WhatsApp in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work

The card, the iframe and the JSON are in English. Add ?lang=it, fr, de or es to their address for another language.

README badge

Badge preview, lightBadge preview, dark
Markdown
[![GREEN-API WhatsApp on mcp.tc](https://mcp.tc/i/green-api-whatsapp/badge.svg)](https://mcp.tc/i/green-api-whatsapp)
HTML
<a href="https://mcp.tc/i/green-api-whatsapp"><img src="https://mcp.tc/i/green-api-whatsapp/badge.svg" alt="GREEN-API WhatsApp on mcp.tc" height="20"></a>

It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.

Website card

HTML
<script src="https://mcp.tc/w/green-api-whatsapp.js" async></script>

The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.

iframe

HTML
<iframe src="https://mcp.tc/embed/green-api-whatsapp" title="GREEN-API WhatsApp on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.

JSON

The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).

https://mcp.tc/i/green-api-whatsapp.json

What each field means

AI prompt

Paste this into an AI coding assistant, such as Claude Code or Cursor, and it adds the GREEN-API WhatsApp card to your site.

Markdown
Add the mcp.tc card for GREEN-API WhatsApp, an MCP server, to my website. It is one static script: no build step, no package to install, no cookies.

Put this tag where the card should appear. The card renders right before it:

```html
<script src="https://mcp.tc/w/green-api-whatsapp.js" async></script>
```

To show the card somewhere else, put this placeholder there and load the same script once, for example before `</body>`. Keep the link inside: visitors without JavaScript see it.

```html
<div data-mcptc="green-api-whatsapp"><a href="https://mcp.tc/i/green-api-whatsapp">GREEN-API WhatsApp on mcp.tc</a></div>
```

Options:
- `data-theme="light"` or `"dark"` on the tag or the placeholder fixes the colors. Without it, the card follows the visitor’s light or dark mode.
- `data-size="compact"` gives a smaller card without the tagline.
- The CSS variable `--mcptc-max-width` on the placeholder or a parent sets the width (default `520px`).
- `?lang=` on the script URL sets the card’s language: `en`, `it`, `fr`, `de` or `es`.

If the site has a Content Security Policy, allow `script-src https://mcp.tc` and `img-src data:` (the icon is inline).

For a README or other Markdown docs, use the badge instead:

```markdown
[![GREEN-API WhatsApp on mcp.tc](https://mcp.tc/i/green-api-whatsapp/badge.svg)](https://mcp.tc/i/green-api-whatsapp)
```

Reference: https://mcp.tc/embed

Change history

Its tools are behind a sign-in, so we can’t read them. Edits by its owner show up here.

Follow GREEN-API WhatsApp and we’ll email you when something changes.

  1. , Automatic check

    Tracking started: 41 tools.

FAQ

Can I paste mcp.tc/i/green-api-whatsapp into my MCP client?

No. mcp.tc links are pages, not server addresses. Connect with https://mcp.green-api.com/mcp, so your client talks to GREEN-API WhatsApp directly. Your key goes there too, never to mcp.tc. The quick link is for sharing: it opens this page, with setup steps for every client.

Does GREEN-API WhatsApp need an API key or a sign-in?

Yes. GREEN-API WhatsApp needs an API key, sent as the X-Instance-Id header. Get one from GREEN-API and keep it in your client’s config, never in a shared file.

Is GREEN-API WhatsApp a remote or a local server?

Remote. GREEN-API hosts it at https://mcp.green-api.com/mcp, and it speaks Streamable HTTP. There’s nothing to install.

What can GREEN-API WhatsApp do?

It has 41 tools, including whatsapp_add_group_participant, whatsapp_check_whatsapp and whatsapp_connect. You can send text, files, locations, contacts and polls, edit, forward and delete messages and read chat history and recent incoming or outgoing messages.

Which clients can use it?

Any client that supports remote MCP servers and can send your key: Claude Code, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. On claude.ai and Claude Desktop, add the key as a request header when you create the custom connector. ChatGPT can’t send a key, so it can’t use it.

Does mcp.tc track changes to GREEN-API WhatsApp?

Partly. GREEN-API WhatsApp’s tools are behind a sign-in, so its History tab shows only edits by its owner. Follow the listing to get an email when it changes.

Who wrote this page?

mcp.tc’s robot read GREEN-API WhatsApp’s own metadata (its MCP handshake, tool list and public pages), and an AI model drafted the text from it. A person reviews anything the checks can’t confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

mcp.tc isn’t affiliated with GREEN-API. This page was built from GREEN-API WhatsApp’s public metadata, last checked on 18 Nov 2026, and an AI model wrote the description, so it can be wrong. Names and marks belong to their owners. Something off? Report this listing.