workspace_quotasLABSCO SUMMARY
Reads are free to explore; sends are real to a real person.
The read half — filtering chats, pulling history around a message, inspecting leads and quotas — is where most of the value sits and none of the risk. Before the first bulk action, workspace_quotas is worth a call: MCP messages and UI messages come out of the same monthly budget.
What it is
A hosted MCP server for a TimelinesAI WhatsApp inbox. It is a remote control for the real inbox, not a sandbox — every action runs as you, with your TimelinesAI role's permissions, and recipients cannot tell a message came from an assistant rather than the UI.
What you get
- Workspace meta (3) —
workspace_quotasfor plan, seats, messaging and API quotas and billing period;workspace_whatsapp_accounts;workspace_teamfor teammates, roles and the emailschat_assignexpects - Chat discovery and inspection (5) —
list_chatsfiltered by status, labels, assignee, group or direct, phone, name, dates and WhatsApp account, paginated 50 per page;chat_details,chat_history,get_chat_messages,message_details - Messaging (4) —
chat_send_messagein an existing chat,whatsapp_account_send_messageto any phone via a chosen account (creating the chat if none exists),message_reply,message_react - Chat mutations (6) —
chat_open,chat_close,chat_assign,chat_unassign,chat_set_label,chat_remove_label; the label and assign operations are idempotent - Messaging draws on the same monthly budget as the TimelinesAI UI —
workspace_quotasshows the headroom
Requirements
A working TimelinesAI production account with at least one WhatsApp account connected — without a connected number most tools return empty or error. Node.js 18+ locally, because Cursor, Claude Desktop and Claude Code launch the mcp-remote proxy with npx against https://mcp.services.timelines.ai/mcp. Authorization is OAuth: a browser tab opens on first connection and the token is cached by mcp-remote afterwards. Writes are real and immediate, with no undo and no sandbox mode.
Setup effort
One command — claude mcp add timelinesai -- npx -y mcp-remote@latest https://mcp.services.timelines.ai/mcp --host 127.0.0.1
USE CASES
01
Triaging an inbox that got away from you
Filter for unread or unassigned chats, then label and assign them to the right teammate.
02
Understanding what happened in a conversation
Pull the context window around the message in question rather than the whole thread.
03
Replying without opening the app
Send into an existing chat, or reply in thread to a specific message.
04
Checking how much messaging budget is left
Read the current plan, quota and billing period before a batch send.
18 tools
Listed in project docs. Your client may show a different list.
workspace_whatsapp_accountsworkspace_teamlist_chatschat_detailschat_historyget_chat_messagesmessage_detailschat_send_messagewhatsapp_account_send_messagemessage_replymessage_reactchat_openchat_closechat_set_labelchat_remove_labelchat_assignchat_unassignBEFORE YOU INSTALL
What to know first
Tools you get
18 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 18+
INSTALLATION
Connect your client
Server setup
claude mcp add
Claude Code
TERMINAL
claude mcp add timelinesai -- npx -y mcp-remote@latest https://mcp.services.timelines.ai/mcp --host 127.0.0.1Hosted endpoint
ENDPOINT URL
https://mcp.services.timelines.ai/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Cursor, Claude Desktop
JSON
{
"mcpServers": {
"timelinesai": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.services.timelines.ai/mcp",
"--host",
"127.0.0.1"
]
}
}
}
