WhatsApp MCP by TimelinesAI

io.github.InitechSoftware由 GitHub 帳號 InitechSoftware 發布v1.0.2更新於 Oct 25, 2026

Ask questions across your WhatsApp inbox from Claude, ChatGPT, Cursor or any MCP client.

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作

概覽

AI 產生的概覽

一個託管式 MCP 伺服器，把 AI 助理接入 TimelinesAI 的 WhatsApp 收件匣，以你的身分讀取、回覆、貼標籤和分配對話。

可以做什麼
探索並讀取對話與訊息，可依狀態、標籤、負責人、電話和日期篩選，涵蓋 QR 碼連接的號碼和 WhatsApp Business API 號碼，並可查看單一訊息詳情與分頁歷史。傳送訊息、串接回覆和表情回應，包括向新號碼發起首次傳送。整理對話：開啟、關閉、指派或取消指派負責人，以及新增或移除標籤。處理 WABA 範本：列出已核准的範本、檢視其元件並傳送，以及檢查對話的服務視窗是否開啟。檢視工作區資訊：方案、席次、配額與計費週期、已連接的 WhatsApp 帳號，以及團隊成員的角色和電子郵件。
適用情境
適合透過 TimelinesAI 處理 WhatsApp 客戶溝通的團隊，讓助理從提示中整理哪些訊息需要回覆、起草並傳送回覆，或依標籤和負責人整理對話。QR 碼連接的號碼和 WhatsApp Business API 號碼都適用。
執行需求
需要 TimelinesAI 帳號，且工作區中至少連接一個 WhatsApp 號碼；否則多數工具會回傳空結果或錯誤。需要支援 Streamable HTTP 的遠端 MCP 用戶端，連接到託管端點，並在瀏覽器中透過 OAuth 登入一次。無需 API 金鑰或安裝；可選的外掛方式需要 Node.js 18 以上。
安裝前請注意
它控制的是真實收件匣，沒有沙箱：寫入立即生效且無法復原，收件者無法分辨訊息來自助理。操作依你在 TimelinesAI 中的角色權限執行。傳送會佔用與介面相同的每月訊息配額，透過 waba_start_chat 和 waba_chat_send_template 傳送的 WABA 範本訊息由 Meta 計費。批次操作前請先確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 WhatsApp MCP by TimelinesAI，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.InitechSoftware%2Fwhatsapp-mcp-by-timelinesai/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "whatsapp-by-timelinesai": {
      "type": "http",
      "url": "https://mcp.services.timelines.ai/mcp"
    }
  }
}

README

WhatsApp MCP by TimelinesAI

Run your team's WhatsApp inbox from Claude, ChatGPT, Cursor or any AI assistant.

[License: MIT] [MCP] [Works with Claude] [Works with ChatGPT] [Works with Cursor] [smithery badge]

Connect your TimelinesAI WhatsApp inbox to Claude, ChatGPT, Cursor, Codex, Grok or any MCP client. Ask what needs a reply, then reply, react, label and assign chats from a prompt. 34 tools, all running as you, for both regular WhatsApp numbers and WhatsApp Business API (WABA) numbers.

Included in every TimelinesAI plan at no extra charge. Website · Setup guide · MCP Academy

What is this?

The TimelinesAI MCP server is a remote control for your real WhatsApp inbox inside TimelinesAI. Connect once with your TimelinesAI login, then your AI assistant gains 34 tools across chat discovery, messaging, triage (labels + assignments) and workspace introspection, for both regular WhatsApp numbers (connected by QR code) and WhatsApp Business API (WABA) numbers.

It's a hosted server: nothing to install, no API keys. Your assistant connects to https://mcp.services.timelines.ai/mcp and you sign in once.

No sandbox. Writes are real and visible to your contacts. Recipients cannot tell whether a message came from the UI or from an AI assistant: it's all just you.

Requirements

  • A TimelinesAI account with at least one connected WhatsApp number in your workspace. Without a connected number, most tools return empty results or errors. The MCP is a remote control for your real inbox, not a sandbox.
  • An AI assistant that supports remote MCP servers (all the clients below do).

Don't have a TimelinesAI account yet? Start a 10-day free trial →

Quick setup (~1 min)

Server URL for every client: https://mcp.services.timelines.ai/mcp

ChatGPT

Open the TimelinesAI plugin in ChatGPT, click Connect and sign in with your TimelinesAI account. Then ask: "@TimelinesAI what needs me today?"

Claude (claude.ai and Claude Desktop)

In Claude, open Customize → Connectors → Add custom connector, paste the server URL and sign in with your TimelinesAI account.

Claude Code

bash
claude mcp add --transport http timelinesai https://mcp.services.timelines.ai/mcp

Claude Code opens a browser tab the first time a tool is used. Sign in with your TimelinesAI account.

Prefer a plugin? /plugin marketplace add InitechSoftware/whatsapp-mcp-by-timelinesai, then /plugin install timelinesai-whatsapp@timelinesai. The plugin launches a local proxy, so it needs Node.js 18+; the command above doesn't.

Cursor

Add to Cursor (one click), or add this to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "timelinesai": {      "url": "https://mcp.services.timelines.ai/mcp"    }  }}

The sign-in window opens on the first tool call.

Codex

Add to ~/.codex/config.toml:

toml
[mcp_servers.timelinesai]url = "https://mcp.services.timelines.ai/mcp"

Then run codex mcp login timelinesai once and approve in the browser. Codex doesn't start the sign-in on its own.

Grok Build

bash
grok mcp add timelinesai https://mcp.services.timelines.ai/mcp

Then type /mcps, select timelinesai and press i to sign in. Grok Build doesn't start the sign-in on its own.

Any other MCP client

Add https://mcp.services.timelines.ai/mcp as a remote server (Streamable HTTP) and sign in when prompted.

See examples/ for ready-to-copy config files.

First thing to try

After connecting, ask your assistant:

"What needs me today?"

or, for a tour:

"What tools does the timelinesai MCP server expose? Group them by purpose and give me one example prompt per group."

Tool catalog (34 tools)

Two parallel sets of tools (one for regular WhatsApp numbers connected by QR code, one for WhatsApp Business API (WABA) numbers) plus three workspace tools shared by both. Use the set that matches the number: workspace_whatsapp_accounts lists QR numbers, waba_accounts lists WABA numbers.

GroupTools
Workspace (shared)3
WhatsApp: QR-connected numbers14
WhatsApp Business API (WABA)17
Total34

Workspace: 3 tools

Read-only introspection. Cheap to call. Shared by both sets.

ToolPurpose
workspace_quotasCurrent plan, seats, messaging + API call quotas, billing period
workspace_whatsapp_accountsConnected QR WhatsApp accounts (id, phone, owner, status)
workspace_teamTeammates, roles, invitation status, account bindings. Use for assign emails in both sets

WhatsApp (QR-connected numbers): 14 tools

Chat discovery + inspection: 4 tools

Browse and read. No writes.

ToolPurpose
list_chatsFilter chats by status, labels, assignee, group/direct, phone, name, dates, WA account. Paginated 50/page
chat_detailsFull metadata for a single chat
chat_historyList messages in a chat. Filter by date and direction, page with message-UID cursors
message_detailsInspect a single message
Messaging writes: 4 tools

Quota-consuming. Same monthly messaging budget as the TimelinesAI UI.

ToolPurpose
chat_send_messageSend a message (text, attachment, or reply) in an existing chat
whatsapp_account_send_messageSend a message to any phone via a specific WA account (creates the chat if none exists: a cold send)
message_replyThreaded reply to a specific message
message_reactSet or clear an emoji reaction on a message
Chat mutations: 6 tools

State + triage operations on chats. Idempotent label and assign ops.

ToolPurpose
chat_openReopen a closed chat
chat_closeClose a chat
chat_assignAssign chat to a teammate by email (use workspace_team to discover emails)
chat_unassignUnassign current responsible teammate
chat_set_labelAdd a label to a chat
chat_remove_labelRemove a label from a chat

WhatsApp Business API (WABA): 17 tools

Accounts + chat discovery: 5 tools

Browse and read. No writes.

ToolPurpose
waba_accountsWABA numbers you can send from. Use id as waba_account_id
waba_list_chatsWABA chats you can see. Filter by open/closed, assignee, WABA account, phone; 50/page. Check service_window_is_open before sending
waba_chat_detailsOne WABA chat: service window, assignment, labels, WABA account
waba_chat_historyMessages in a WABA chat, newest first. Filter by date and direction, page with message-UID cursors
waba_message_detailsInspect one WABA message; failed sends include failure_reason
Templates: 2 tools
ToolPurpose
waba_templatesMessage templates you can use, 50/page. Only APPROVED templates can be sent
waba_template_detailsOne template's components, status, and the WABA accounts it can be sent from. Call before any template send
Messaging writes: 4 tools

Template sends incur a Meta charge. Free text only works while the chat's service window is open.

ToolPurpose
waba_start_chatStart a new chat with a phone number using an approved template. Meta charge
waba_chat_send_messageFree-text message in an existing WABA chat, only while service_window_is_open is true
waba_chat_send_templateSend an approved template in an existing WABA chat: the way to message when the service window is closed. Meta charge
waba_message_reactSet or clear an emoji reaction on a WABA message
Chat mutations: 6 tools

State + triage operations on WABA chats. After any mutation, waba_chat_details returns the authoritative state.

ToolPurpose
waba_chat_openReopen a closed WABA chat
waba_chat_closeClose a WABA chat
waba_chat_assignAssign a WABA chat to a teammate by email (from workspace_team)
waba_chat_unassignClear the WABA chat's assignee
waba_chat_set_labelAdd a label, keeping existing labels
waba_chat_remove_labelRemove one label, keeping the others; no-op if the label isn't on the chat

→ Full schemas and example prompts: docs/tools.md

How sign-in works

The server uses OAuth. The first time your assistant connects, a browser window opens on TimelinesAI. Sign in to your TimelinesAI account and approve access. Your assistant keeps the sign-in, so later sessions reconnect without asking.

If you're already signed in to TimelinesAI in your browser, approval can take a single click.

Every action runs as you: your role's permissions in TimelinesAI apply to MCP calls exactly as they apply to UI actions.

Safety + production behavior

⚠️ This MCP server controls a real WhatsApp inbox. Read this section before sending writes.

  • Messages sent via MCP are indistinguishable from messages sent in the UI. Recipients cannot tell.
  • Writes are real and immediate. No undo. Confirm before bulk actions.
  • Quota is shared with UI usage: MCP messages draw from the same monthly messaging budget. Call workspace_quotas to see headroom.
  • WABA template messages are charged by Meta. waba_start_chat and waba_chat_send_template send approved templates, which Meta bills for. Free-text waba_chat_send_message only works while the chat's service window is open.
  • No sandbox mode. Practice on your own number first if you're unsure.
  • Without a connected WhatsApp number, most tools return empty results or errors. Connect a number in TimelinesAI first.

Get started

  1. Start a 10-day free trial of TimelinesAI →
  2. Connect a WhatsApp number in the TimelinesAI dashboard.
  3. Pick your assistant above and connect it.
  4. Sign in, then ask: "What needs me today?"

Links

License

MIT © 2026 Initech Software / TimelinesAI

來源：README.md，提交 35d4f78

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

2
  1. v1.0.2最新Oct 8, 2026
  2. v1.0.1Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分