FW

finereli/whatsapp-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

396 stars 35 forks Качество 70 Тренд 64MIT

MCP-сервер только для чтения, который позволяет вашему агенту ИИ искать и читать ваши собственные сообщения WhatsApp. Используйте его бесплатно на whatsapp.finereli.com или запустите свою собственную копию на Cloudflare.

Обзор

Подключите ChatGPT, Claude или Grok к WhatsApp. Это MCP-сервер только для чтения по вашей собственной истории сообщений, хранящийся в зашифрованном виде и с открытым исходным кодом. Вы связываете свой телефон один раз, как вы связываете WhatsApp Web, и с этого момента любой клиент MCP может искать и читать ваши чаты. Он ничего не может послать. Построен @finereli. Вопросы и сообщения об ошибках идут здесь или ко мне на X. - Это быстрый способ. Зарегистрируйтесь в Google, отсканируйте QR-код с помощью телефона и добавьте T0 своему агенту. Это бесплатная бета-версия с ограниченным количеством мест и ограничением по размеру на счет. Ваши сообщения зашифрованы в состоянии покоя, но я запускаю службу входа в систему, так что в принципе я мог бы получить ваш ключ. «Что это гарантирует» ниже точно говорит, что это значит. Если вы не хотите мне доверять, запустите свою собственную копию. - в вашей учетной записи Cloudflare. Это то, что описано в руководстве ниже. Бесплатно, за исключением нескольких долларов Cloudflare в месяц, и ключ исходит от пароля, который вы знаете.

Обзор (машинный перевод)

Подключите ChatGPT, Claude или Grok к WhatsApp. Это MCP-сервер только для чтения по вашей собственной истории сообщений, хранящийся в зашифрованном виде и с открытым исходным кодом.

Вы связываете свой телефон один раз, как вы связываете WhatsApp Web, и с этого момента любой клиент MCP может искать и читать ваши чаты. Он ничего не может послать.

Построен @finereli. Вопросы и сообщения об ошибках идут здесь или ко мне на X.

Есть два способа его использования:

Использовать его на whatsapp.finereli.com. Это быстрый способ. Зарегистрируйтесь в Google, отсканируйте QR-код с помощью телефона и добавьте T0 своему агенту. Это бесплатная бета-версия с ограниченным количеством мест и ограничением по размеру на счет. Ваши сообщения зашифрованы в состоянии покоя, но я запускаю службу входа в систему, так что в принципе я мог бы получить ваш ключ. «Что это гарантирует» ниже точно говорит, что это значит. Если вы не хотите мне доверять, запустите свою собственную копию. ** Запустите свою собственную копию** в своей учетной записи Cloudflare. Это то, что описано в руководстве ниже. Бесплатно, за исключением нескольких долларов Cloudflare в месяц, и ключ исходит от пароля, который вы знаете. Любой может запустить его как услугу для других людей: см.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

whatsapp-mcp

Connect ChatGPT, Claude or Grok to your WhatsApp. It is a read-only MCP server over your own message history, stored encrypted, and open source.

You link your phone once, the way you’d link WhatsApp Web, and from then on any MCP client can search and read your chats. It can’t send anything.

Built by @finereli. Questions and bug reports go in an issue here, or to me on X.

There are two ways to use it:

  • Use it at whatsapp.finereli.com. This is the quick way. Sign in with Google, scan the QR code with your phone, and add https://whatsapp.finereli.com/mcp to your agent. It’s a free beta with a limited number of seats and a size limit per account. Your messages are encrypted at rest, but I run the login service, so in principle I could derive your key. “What it guarantees” below says exactly what that means. If you’d rather not trust me, run your own copy.
  • Run your own copy in your Cloudflare account. This is what the setup guide below covers. Free apart from Cloudflare’s few dollars a month, and the key comes from a password only you know. Anyone can also run it as a service for other people: see “Running it for other people”.

The easiest way to set up the hosted version is to let your agent do it. Paste this into Claude, ChatGPT or Grok:

Set up WhatsApp for me via https://whatsapp.finereli.com. Read https://whatsapp.finereli.com/llms.txt and walk me through it.

Ask your agent things like:

  • “What did Dana say about the flights?”
  • “Find every message where someone mentioned the lease, across all my chats.”
  • “Summarize what I missed in the family group this week.”

How it works

Your phone stays the source of truth. The server is a linked device that your agent talks to.

It doesn’t stay connected to WhatsApp. When your agent asks for something, it connects, collects whatever WhatsApp queued for it since last time, writes that to its own database, and hangs up. Your phone keeps working normally and keeps getting notifications.

Your messages live in a SQLite database inside a Durable Object in Cloudflare, one per person, sealed with a key that comes from that person’s sign-in.

What it guarantees, and what it doesn’t

It only reads. There are no tools that send, edit or delete anything in WhatsApp.

Your messages are encrypted at rest. Whether the operator can read them depends on how it is run.

  • Your own copy (OWNER_PASSWORD): the key comes from your password. There is no master key and no recovery key. Not Cloudflare, and not someone who copies the database, can read your stored messages without it.
Открыть полный README на GitHub

Установка

npx wrangler kv namespace create OAUTH_KV
Новичок в MCP? Начните с руководства на mcpskill.org →