TimelinesAI WhatsApp
About
Connect your TimelinesAI WhatsApp inbox to Claude. List chats, read history, send messages, react, label, assign teammates — all as you, in production.
Details
- Author
- InitechSoftware
- Downloads
- 276
- Categories
- Productivity, Other, Communication, AI, Automation
Jump to
- Workspace introspection: plan, seats, quotas, accounts, teammates.
- Chat discovery and inspection: filter by labels, assignee, status, dates.
- Messaging: send messages, reply, add or clear emoji reactions.
- Chat operations: open/close chats, assign/unassign teammates, manage labels.
- 18 tools exposed across workspace metadata, chat discovery, messaging writes, and chat management.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
TimelinesAI WhatsAppCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install by adding a configuration entry to your MCP client using npx mcp-remote@latest pointed at https://mcp.services.timelines.ai/mcp. You need a TimelinesAI production account with at least one connected WhatsApp account and Node.js 18+ installed locally. On first use, a browser tab opens for OAuth 2.0 PKCE authorization; after approval, the server is ready.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"timelinesai whatsapp": {
"timelinesai": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.services.timelines.ai/mcp",
"--host",
"127.0.0.1"
]
}
}
}
}McpServers
{
"timelinesai": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.services.timelines.ai/mcp",
"--host",
"127.0.0.1"
]
}
}Connect your TimelinesAI WhatsApp inbox to Claude. List chats, read history, send messages, react, label, assign teammates — all as you, in production.
Full-blown MCP server — every workspace action exposed to your AI assistant.
Drive yourTimelinesAI WhatsApp inboxfrom Claude, Cursor, Claude Code, or any MCP-compatible client. List chats, read history, send messages, react, label, assign teammates, check quotas — all 18 tools, all asyou, all on the same quota the TimelinesAI UI uses.
The TimelinesAI MCP server is a remote control for your real WhatsApp inbox insideTimelinesAI. Connect once via OAuth, then your AI assistant gains 18 tools acrosschat discovery,messaging,triage(labels + assignments), andworkspace introspection.
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.
- A workingTimelinesAI production accountwithat least one connected WhatsApp accountin your workspace. Without a connected WA, most tools will return empty or error — the MCP is a remote control for your real inbox, not a sandbox.
- Node.js 18+locally (Cursor / Claude Desktop / Claude Code usenpxto launch themcp-remoteproxy).
Don't have a TimelinesAI account yet?Sign up free →
claude mcp add timelinesai -- npx -y mcp-remote@latest https://mcp.services.timelines.ai/mcp --host 127.0.0.1
Restart Claude Code. A browser tab will open on first use — log in with your TimelinesAI account to authorize. Done.
Prefer one-step install via the TimelinesAI plugin marketplace:
/plugin marketplace add InitechSoftware/whatsapp-mcp-by-timelinesai /plugin install timelinesai-whatsapp@timelinesai
This auto-wires the MCP server — no manual config. A browser tab opens on first use for OAuth. Update later with/plugin marketplace update timelinesai.
{ "mcpServers": { "timelinesai": { "command": "npx", "args": [ "-y", "mcp-remote@latest", "https://mcp.services.timelines.ai/mcp", "--host", "127.0.0.1" ] } } }
OpenSettings → Developer → Edit Configand add:
{ "mcpServers": { "timelinesai": { "command": "npx", "args": [ "-y", "mcp-remote@latest", "https://mcp.services.timelines.ai/mcp", "--host", "127.0.0.1" ] } } }
Fully quitClaude Desktop (not just close the window) and reopen. A browser tab will open for OAuth on first use.
Seeexamples/for ready-to-copy config snippets per client.
"What tools does the timelinesai MCP server expose? Group them by purpose and give me one example prompt per group."
That gives you a personalized tour of what's available without reading any docs.
Quota-consuming.Same monthly messaging budget as the TimelinesAI UI.
State + triage operations on chats. Idempotent label and assign ops.
→ Full schemas and example prompts:docs/tools.md
The server uses OAuth via themcp-remoteproxy. On first connection, your browser opens tomcp.services.timelines.ai— log in to your TimelinesAI account to authorize. Token is cached locally bymcp-remote; subsequent sessions reconnect without prompting.
On machines that already have an active TimelinesAI session (e.g. you're logged in to TimelinesAI in your default browser, or you've previously authorized the MCP via the Claude.ai integration), authorization may complete silently with no browser prompt.
Every action runsas you— your role's permissions in TimelinesAI apply to MCP calls exactly as they apply to UI actions.
⚠️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 sharedwith UI usage — MCP messages draw from the same monthly messaging budget. Callworkspace_quotasto see headroom.
- No sandbox mode.Practice on your own number first if you're unsure.
- Without a connected WhatsApp account, most tools return empty results or errors. Connect a WA account in TimelinesAI first.
- Sign up for TimelinesAI →
- Connect a WhatsApp account in the TimelinesAI dashboard.
- Pick your client above (Claude Code, Cursor, or Claude Desktop) and paste the config.
- Restart, authorize, ask your assistant what it can do.
- TimelinesAI—timelines.ai
- Sign up—app.timelines.ai/register
- MCP server endpoint—https://mcp.services.timelines.ai/mcp
- Model Context Protocol—modelcontextprotocol.io
- mcp-remoteproxy—npm
- Issues / feedback—open an issuein this repo
MIT© 2026 Initech Software / TimelinesAI
Local Messaging and Task Tracking to Connect Claude Code, Codex, OpenCode and Pi agents
Manage your WhatsApp, SMS and Phone Calls using a single MCP connector
Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.
143 local tools for Claude, Cursor & ChatGPT — Mail, iMessage, Teams, Slack, WhatsApp & files. 100% local, no API keys.
Salesforce MCP Server - Enhanced Edition
A Salesforce MCP server with automatic integrations for services such as WhatsApp, Slack, email, and custom webhooks.
Send SMS, MMS, WhatsApp messages, make voice calls, and manage Twilio phone numbers
Automate WhatsApp by sending messages, summarizing conversations, and managing chats using natural language with AI assistants.
Inspect Wapiworld sender and webhook health, and send one explicitly confirmed WhatsApp text.
Search, read, and send personal WhatsApp messages, contacts, and media files.
A WhatsApp MCP (Model Context Protocol) server that connects your WhatsApp account with AI agents, enabling automated messaging, contact search, and chat interaction through LLMs.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
