automata-mcp
Open-source PostgreSQL, WhatsApp, Telegram & Email MCP server for Claude, ChatGPT, and Cursor — with per-table, per-chat, and per-folder permissions. Self-hostable or hosted.
Install / Use
claude mcp add ju-li -- npx -y github:ju-li/automata-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Our assessment of automata-mcp
automata-mcp scores 83/100 on our quality scale, 2145th of 2,769 Automation skills we index.
Its MCP Server is 19 KB long, well organised into 20 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so automata-mcp is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
automata-mcp compared with similar skills
All 4 of these similar skills score higher than automata-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| automata-mcp (this skill)by ju-li | 83 | 10 | today | MCP Server |
| claude-memby thedotmack | 100 | 117.9k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install automata-mcp?
- Run
claude mcp add ju-li -- npx -y github:ju-li/automata-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does automata-mcp work with?
- It is written for Claude Code, Claude Desktop and Cursor, as a MCP Server file. Other agents that read the same format can often use it too.
- Is automata-mcp safe to use?
- It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is automata-mcp still maintained?
- The repository was last updated today, so automata-mcp is actively maintained.
Skill content
View source on GitHubAutomata — PostgreSQL, WhatsApp, Telegram & Email MCP Server
Automata is a free, open-source PostgreSQL, WhatsApp, Telegram and email (IMAP) MCP server that connects Claude, ChatGPT, Cursor and other AI agents to your database, chats and mailbox. Every connector token is scoped table by table, chat by chat and folder by folder, so the AI sees only what you shared, whether you use the hosted version or self-host it.
Many MCP servers give the AI everything the account can reach. Automata issues a connector token for one connection at a time and limits it to the actions, chats, email folders or tables you choose, so the AI sees only what you shared. It is for individuals and teams who want an AI assistant to read, search and (only if allowed) reply in their messages, mail or database. It is MIT-licensed: use the hosted version or run it yourself.
Why Automata: read-only and scoped by default
- PostgreSQL MCP server with table-by-table allowlists. Every statement's
query plan is checked against the token's tables before a row is read;
queries run read-only, and writes need the
run-statementtool granted. - WhatsApp and Telegram MCP server with chat-by-chat scoping. A token can be limited to listed chats and groups; sending needs the send tool and reaches only chats in scope.
- Read-only IMAP email access. The AI can list, search and read mail and attachments in the folders you choose. It cannot send, move, flag or delete; at most it saves drafts for you to review.
- One token, one connection. No tool takes an account or database argument, and tokens can expire, be rotated or be revoked.
MCP tools reference · plain-text docs for AI tools: llms.txt, llms-full.txt
What you can connect
Automata is a PostgreSQL MCP server, a WhatsApp MCP server, a Telegram MCP server and an email (IMAP) MCP server in one deployment. It connects four kinds of account; each connection gets its own connector token.
| Connector | Status | What the AI can do | How it connects | More | |---|---|---|---|---| | WhatsApp | Available | List chats, read and search messages (groups included), send text | Your number paired by QR code as a linked device, through Evolution API | WhatsApp MCP server | | Telegram | Available | List chats, read and search messages, send text | Your personal account linked by QR code as an extra device (not the Bot API) | Telegram MCP server | | Email (IMAP) | Available | List folders, list, search and read email, fetch attachments, save drafts. Cannot send, move, flag or delete | IMAP username and app password | Email setup guide | | PostgreSQL | Available | List and describe tables, run read-only queries, and run writes only when the write tool is granted | A connection string, ideally for a least-privilege role | PostgreSQL MCP server |
Supported AI clients
The PostgreSQL MCP server, WhatsApp MCP server, Telegram MCP server and email MCP server work with Claude, ChatGPT, Cursor and any other AI client or agent that supports custom (remote) MCP connectors over streamable HTTP. These have step-by-step guides:
- Claude (Claude.ai, Claude Desktop, Claude Code): WhatsApp, Telegram, email, PostgreSQL
- ChatGPT: WhatsApp
- Cursor: WhatsApp
- Grok: WhatsApp, Telegram
- Meta Muse: WhatsApp, Telegram
- Hermes Agent: WhatsApp
All clients and connection methods: https://www.getautomata.app/docs/clients.
Quick start
Use the hosted version, or self-host with Railway or Docker.
-
Hosted: sign up at mcp.getautomata.app. The MCP endpoint is
https://mcp.getautomata.app/mcp. -
Railway (one click): <a href="https://railway.com/deploy/automata-or-whatsapp-telegram-sql-mcp?referralCode=HxrUPo&utm_medium=integration&utm_source=template&utm_campaign=generic"><img src="https://railway.com/button.svg" alt="Deploy on Railway" align="center"></a>
-
Docker (single container):
docker run -d --name automata --restart unless-stopped --stop-timeout 30 \ -p 3000:3000 -v automata_data:/data \ -e NUXT_PUBLIC_APP_URL=https://automata.example.com \ ghcr.io/ju-li/automata-mcp-aio:1
Then create a connection, mint a connector token on its dashboard, and add the connector URL to your AI client. Full steps: https://www.getautomata.app/docs/getting-started.
How permissions work
Every connector token is bound to exactly one connection and can do only what it was granted.
- One token, one connection. No tool takes an account or database argument, so the AI cannot address another number, mailbox or database.
- Actions. A token gets all tools or a chosen few. Tools outside its scope are not registered for that request, so calling one fails. New PostgreSQL and email tokens start read-only.
- Chats, folders and tables. A token can be limited to listed WhatsApp or Telegram chats, email folders, or database tables. Anything outside is refused by name. Searches, and the Telegram, email-folder and table listings, exclude it in the query itself; the WhatsApp chat list drops out-of-scope chats from each page it reads.
- Database checks. Read queries run one statement at a time in a read-only transaction. Every statement's query plan is checked against the table allowlist before a row is read. The real security boundary is the database role in the connection string, so use a least-privilege role.
- What the AI cannot do. It cannot send without the send tool, write to a
database without
run-statement, or send email at all (it can only save drafts). It cannot widen its own scope. - Token handling. Tokens are shown once and stored only as a SHA-256 hash.
They can expire, be rotated or be revoked. Clients send them as
Authorization: Bearer <token>, or in the URL path (/mcp/<token>) for clients that cannot set headers.
Details: https://www.getautomata.app/docs/permissions.
MCP tools
Automata has 22 MCP tools; a connection only exposes the tools for its kind. Full reference: https://www.getautomata.app/docs/reference/mcp-tools.
| Connector | Tool | What it does |
|---|---|---|
| WhatsApp | get-connection-status | Whether the account is paired and connected |
| | list-chats | Chats in scope, most recently active first |
| | read-messages | One chat's messages, newest first, paged, with optional date range |
| | search-messages | Messages containing every word of a query |
| | send-text-message | Send a text message (write) |
| Telegram | get-telegram-status | Whether the account is linked and online, and sync progress |
| | list-telegram-chats | Synced chats in scope: private chats, groups, supergroups, channels |
| | read-telegram-messages | One chat's messages, newest first, paged |
| | search-telegram-messages | Messages and captions containing every word of a query |
| | send-telegram-message | Send plain text to a chat, @username or phone number (write) |
| Email | get-mailbox-status | Which mailbox, whether sync works, when it last ran |
| | list-mail-folders | Folders in scope with synced and unread counts |
| | list-emails | Email headers, newest first, with filters |
| | search-emails | Search by sender, recipient, subject, date or body text |
| | read-email | One email's body as plain text and its attachment list |
| | get-email-attachment | One attachment, fetched live from the mail server |
| | create-email-draft | Save an unsent plain-text draft in Drafts (write, never sends) |
| PostgreSQL | get-database-info | Server version, database, role, and the token's scope |
| | list-tables | Tables in scope |
| | describe-table | Columns, keys, constraints, indexes and comments |
| | run-query | One read-only query, paged; explain: true returns the plan instead |
| | run-statement | One INSERT / UPDATE / DELETE / MERGE, rolled back if it exceeds a row cap (write) |
FAQ
What is Automata? Automata is a free, open-source MCP server that lets AI clients such as Claude and ChatGPT use your WhatsApp, Telegram, email and PostgreSQL, limited to the chats, folders and tables you grant each connector token.
Is Automata free? Yes. The code is MIT-licensed and free to self-host. The hosted version has a free plan with one connection, one connector token and one user; Pro has unlimited connections and tokens and starts with a 7-day trial.
Does it use the official WhatsApp Business API? No. Automata pairs your own WhatsApp number as a linked device through Evolution API (the Baileys integration), the way WhatsApp Web links. Pairing a real number carries a risk of restriction or bans, so use a spare number for testing.
Can the AI read WhatsApp groups? Yes. Group chats are listed and readable like one-to-one chats, and a token can be limited to specific groups or chats.
Can the AI send messages? Yes, but only if the token is granted the send tool, and only to the chats in its scope. Email is different: the AI can save drafts for you to review, but it cannot send email.
Is it safe to give Claude database access?
Yes, when you use a least-privilege database role. Queries are read-only by
default, run one statement at a time, and are checked against the token's table
allowlist through the query plan; writes need the run-statement tool granted
explicitly. The database role is the real boundary, so do not connect a
superuser. See https://www.getautomata.app/docs/connections/postgresql.
Should I self-host or use the hosted version? Use the hosted version to start in minutes without running servers. Self-host if you want your messages and credentials on your own infrastructure, want full WhatsApp history import without a paid plan, or want to use your own Evolution API server or Telegram bridge, which only self-hosted deployments allow.
Screenshots
<p align="center"> <img src="docs/images/claude-chaTruncated for display — read the full file on GitHub.
Related Skills
claude-mem
117.9kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
