SkillAgentSearch skills...

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-mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

83/100

Category

Automation

Supported Platforms

Claude Code
Claude Desktop
Cursor

Tags

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.

Substance
30/30
Structure
18/20
Description
15/15
Adoption
4/20
Freshness
15/15

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.

SkillScoreStarsUpdatedFormat
automata-mcp (this skill)by ju-li8310todayMCP Server
claude-memby thedotmack100117.9ktodayCLAUDE.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.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.
<p align="center"> <a href="https://getautomata.app"> <picture> <source media="(prefers-color-scheme: dark)" srcset="docs/images/logo-dark.svg"> <img src="docs/images/logo-light.svg" alt="Automata" width="300"> </picture> </a> </p> <p align="center"> <a href="https://getautomata.app">Website</a> · <a href="https://mcp.getautomata.app/signup">Sign up</a> · <a href="https://www.getautomata.app/docs">Documentation</a> · <a href="https://www.getautomata.app/contact">Contact</a> </p> <p align="center"> <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"></a> </p>

Automata — 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-statement tool 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:

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-cha

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars10
CategoryAutomation
Updated9h ago
Forks3

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 info
automata-mcp — MCP Server: Install & Safety Check | SkillAgent