zalo-oa-mcp

MCP server for Zalo Official Account API (Vietnam). Send messages, manage followers, publish articles, and manage your Zalo OA.

Tools (8)

| Tool | Description | |---|---| | send_message | Send message to a follower | | send_broadcast | Broadcast message to followers | | get_followers | List OA followers | | get_user_profile | Get user profile | | create_article | Create an article | | list_articles | List OA articles | | upload_image | Upload image to Zalo | | get_oa_info | Get OA information |

Quick Start

{
  "mcpServers": {
    "zalo-oa": {
      "command": "npx",
      "args": ["-y", "@theyahia/zalo-oa-mcp"],
      "env": {
        "ZALO_OA_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |---|---|---| | ZALO_OA_ACCESS_TOKEN | Yes | OA access token from Zalo Developer | | ZALO_APP_ID | No | App ID (for OAuth flows) | | ZALO_APP_SECRET | No | App secret (for OAuth flows) |

Demo Prompts

• "Send 'Hello!' to Zalo user u123"
• "Broadcast a sale announcement to all followers"
• "Get my OA follower count"
• "Create an article about our new product"

License

MIT