# Automata

> Automata is a free, open-source MCP access control layer that connects AI agents like Claude and ChatGPT to WhatsApp, Telegram, and PostgreSQL with strictly enforced chat-by-chat and table-by-table permissions.

The full documentation is available as one plain-text file at https://www.getautomata.app/llms-full.txt.

## Product

- [Automata — The access control layer for AI](https://www.getautomata.app/)
- [WhatsApp MCP Server: Connect Claude & ChatGPT to WhatsApp](https://www.getautomata.app/whatsapp-mcp): Free, open-source WhatsApp MCP server. Connect Claude, ChatGPT, and Cursor to WhatsApp with per-chat permissions: the AI reads and replies only in the chats you allow.
- [Telegram MCP Server: Connect Claude & ChatGPT to Telegram](https://www.getautomata.app/telegram-mcp): Free, open-source Telegram MCP server. Connect Claude, ChatGPT, and Cursor to Telegram with per-chat permissions: the AI reads and replies only in the chats you allow.
- [PostgreSQL MCP Server: Connect Claude & ChatGPT to Postgres](https://www.getautomata.app/postgres-mcp): Free, open-source PostgreSQL MCP server. Connect Claude, ChatGPT, and Cursor to your database for analytics with per-table permissions and query plan checks.

## Docs: Start here

- [Overview](https://www.getautomata.app/docs): Choose a connector and follow the shortest path to your first MCP request.
- [Getting started](https://www.getautomata.app/docs/getting-started): Run Automata locally and connect an MCP client.
- [How Automata works](https://www.getautomata.app/docs/how-automata-works): Understand connections, tokens, scopes, and the services behind each connector.

## Docs: Connect data sources

- [WhatsApp](https://www.getautomata.app/docs/connections/whatsapp): Pair an account through Evolution API and enable message history.
- [Telegram](https://www.getautomata.app/docs/connections/telegram): Link a personal Telegram account through the bridge service.
- [PostgreSQL](https://www.getautomata.app/docs/connections/postgresql): Connect a database with a least-privilege role and guarded tools.
- [Email (IMAP)](https://www.getautomata.app/docs/connections/email): Connect one mailbox over IMAP for reading, search, and unsent drafts.

## Docs: Control access

- [Tokens and permissions](https://www.getautomata.app/docs/permissions): Grant only the actions, chats, and tables an AI client needs.
- [Telemetry](https://www.getautomata.app/docs/telemetry): What tool-call telemetry records, and why it never applies to self-hosted deployments.
- [Organizations and roles](https://www.getautomata.app/docs/organizations): Invite teammates and understand who can manage connections and tokens.
- [Two-factor authentication](https://www.getautomata.app/docs/two-factor): Protect web sign-in with authenticator apps, passkeys, and recovery codes.
- [MCP clients](https://www.getautomata.app/docs/clients): Use header-based or path-token authentication from supported MCP clients.

## Docs: Self-host and operate

- [Single container](https://www.getautomata.app/docs/self-hosting/single-container): Run the whole stack with one docker run and one volume.
- [Docker Compose](https://www.getautomata.app/docs/self-hosting/docker-compose): Self-host the published images on any Docker host.
- [Local deployment](https://www.getautomata.app/docs/self-hosting/local): Run the core, WhatsApp, or Telegram service profiles locally.
- [Railway deployment](https://www.getautomata.app/docs/self-hosting/railway): Deploy each service with the right roots, volumes, ports, and replica count.
- [Configuration](https://www.getautomata.app/docs/self-hosting/configuration): Reference the environment variables used by each service.
- [Releases](https://www.getautomata.app/docs/self-hosting/releases): Image tags, version pinning, and safe upgrades.
- [Security](https://www.getautomata.app/docs/self-hosting/security): Harden credentials, network access, connector tokens, and backups.
- [Connection alerts](https://www.getautomata.app/docs/alerts): Get emailed when a messenger connection disconnects.
- [Troubleshooting](https://www.getautomata.app/docs/troubleshooting): Diagnose pairing, history, webhook, networking, and volume problems.

## Docs: Reference

- [MCP tools](https://www.getautomata.app/docs/reference/mcp-tools): All 22 tools, grouped by connector with scope and safety behavior.

## Docs: Contribute

- [Development](https://www.getautomata.app/docs/development): Repository layout, scripts, auth paths, and adding an MCP tool.

## Guides

- [5 Grok Bot use cases for small businesses](https://www.getautomata.app/blog/grok-bot-use-cases-for-small-businesses): Five jobs a small business can hand to Grok Bot: answering new leads, chasing late invoices, a morning brief, tracking supplier promises, and daily sales numbers. Each comes with the data behind it, an example, and the prompt to start with.
- [Automata vs Nango: which one connects AI to your data?](https://www.getautomata.app/blog/automata-vs-nango): Automata vs Nango compared with sources: license, what free self-hosting includes, price, permissions, WhatsApp and Telegram, and logging, plus where Nango is the better choice.
- [Automata vs Composio: open-source, self-hosted MCP compared](https://www.getautomata.app/blog/automata-vs-composio): Automata vs Composio compared: source code, self-hosting, price, per-chat and per-table permissions, personal WhatsApp and Telegram, logging, and credential custody, plus where Composio is the better choice.
- [How to connect Meta Muse to Telegram](https://www.getautomata.app/blog/how-to-connect-meta-muse-to-telegram): Meta Muse has no Telegram integration, so it cannot read your chats or send replies. Connect Meta Muse to your own Telegram with Automata, a free, open-source MCP server, in five steps.
- [How to connect Grok Bot to Telegram](https://www.getautomata.app/blog/how-to-connect-grok-bot-to-telegram): Connect Grok Bot to your Telegram chats using Automata, a free, open-source MCP server. Add it as a custom MCP server with a bearer API key, then ask Grok Bot which groups need a reply from you.
- [How to connect Claude to Telegram](https://www.getautomata.app/blog/how-to-connect-claude-to-telegram): Connect Claude.ai, Claude Desktop, and Claude Code to your Telegram chats with Automata, a free, open-source MCP server. Link your account by QR code, choose the chats Claude can see, and add the connector in five steps.
- [How to connect Meta Muse to WhatsApp](https://www.getautomata.app/blog/how-to-connect-meta-muse-to-whatsapp): Muse already lets you message it from WhatsApp, but it cannot read your chats or send replies. Connect Meta Muse to your own WhatsApp with Automata, a free, open-source MCP server, in five steps.
- [How to connect Claude to email (Fastmail, Zoho, iCloud and more)](https://www.getautomata.app/blog/how-to-connect-claude-to-email): Connect Claude to a Fastmail, Zoho, iCloud, Yahoo, or any other IMAP mailbox with Automata, a free, open-source MCP server. Read-only by default, scoped to the folders you choose.
- [How to give Claude read-only Postgres access safely](https://www.getautomata.app/blog/how-to-give-claude-read-only-postgres-access-safely): How to give Claude read-only Postgres access safely: a least-privilege role, query-plan allowlists, and an honest look at what they don't protect against.
- [How to connect Cursor to WhatsApp](https://www.getautomata.app/blog/how-to-connect-cursor-to-whatsapp): Connect Cursor to WhatsApp with Automata, a free, open-source MCP server. Pair your account, choose the chats Cursor can see, and add the server to mcp.json in five steps.
- [How to connect ChatGPT to WhatsApp](https://www.getautomata.app/blog/how-to-connect-chatgpt-to-whatsapp): 1-800-CHATGPT stopped working on WhatsApp in most countries. Connect ChatGPT to your own WhatsApp chats instead with Automata, a free, open-source MCP server, in five steps.
- [How to connect Hermes Agent to WhatsApp safely](https://www.getautomata.app/blog/how-to-connect-hermes-agent-to-whatsapp-safely): Hermes Agent's built-in WhatsApp connector links the agent to your whole account. Use the Automata MCP server instead to choose exactly which chats and actions Hermes can use.
- [How to prototype landing page designs with v0](https://www.getautomata.app/blog/how-to-prototype-landing-page-designs-with-v0): A real walkthrough of using v0 to redesign a landing page headline: ask for three concepts on an unlisted page, compare them on desktop and mobile, approve one, and publish.
- [How to connect Grok Bot to WhatsApp](https://www.getautomata.app/blog/how-to-connect-grok-bot-to-whatsapp): Connect Grok Bot to WhatsApp using Automata, a free, open-source MCP server. Add it as a custom MCP server with a bearer API key, then ask Grok Bot to find open action items in your chats.
- [Tutorial: Free AI Chief of Staff for your WhatsApp](https://www.getautomata.app/blog/free-ai-chief-of-staff-for-whatsapp): Build a free, read-only AI chief of staff for WhatsApp with Claude and Automata. Turn chats into tasks, get a morning brief, track what people owe you, and keep your messages on infrastructure you control.
- [How to recreate Malfoid AI videos with Higgsfield](https://www.getautomata.app/blog/how-to-recreate-malfoid-with-higgsfield): Recreate the Malfoid trend with Higgsfield: build a consistent anime-style character, animate her with Seedance, and keep her face and outfit identical across every clip of your series.
- [How to recreate AI influencers such as Jean Philanthrope with Higgsfield](https://www.getautomata.app/blog/how-to-recreate-jean-philanthrope-with-higgsfield): Recreate AI influencers like Jean Philanthrope with Higgsfield AI Influencer: write a character sheet, build a consistent look, then use motion transfer to put your character in any scene.
- [How to connect WhatsApp to Claude](https://www.getautomata.app/blog/how-to-connect-whatsapp-to-claude): Connect Claude.ai, Claude Desktop, and Claude Code to WhatsApp with a free, open-source MCP server. Pair your account, choose the chats Claude can see, and add the connector in five steps.

## Optional

- [Full documentation as plain text](https://www.getautomata.app/llms-full.txt)
- [Source code on GitHub](https://github.com/ju-li/automata-mcp)
- [Deploy on Railway](https://railway.com/deploy/automata-or-whatsapp-telegram-sql-mcp)
- [Contact](https://www.getautomata.app/contact)
- [Privacy policy](https://www.getautomata.app/privacy)
- [Terms](https://www.getautomata.app/terms)