
finereli/whatsapp-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
AI 에이전트를 검색하고 자신의 WhatsApp 메시지를 읽을 수있는 읽기 전용 MCP 서버. whatsapp.finereli.com에서 무료로 사용하거나 Cloudflare에서 자신의 사본을 실행하십시오.
개요
WhatsApp에 ChatGPT, Claude 또는 Grok를 연결하십시오. 그것은 자신의 메시지 역사, 저장된 암호화 및 오픈 소스를 통해 MCP 서버 만입니다. 전화를 한 번 연결하면 WhatsApp 웹을 연결하고 MCP 클라이언트에서 채팅을 검색하고 읽을 수 있습니다. 그것은 아무것도 보낼 수 없습니다. @finereli에 의해 건축하는. 질문과 버그 보고서는 여기에 문제가 있거나 X에 나와 있습니다. - 이것은 빠른 방법입니다. Google과 로그인하여 휴대폰으로 QR 코드를 스캔하고 https://whatsapp.finereli.com/mcp을 에이전트에 추가합니다. 좌석 수와 계정 당 크기 제한을 가진 무료 베타입니다. 귀하의 메시지는 나머지에서 암호화되지만, 로그인 서비스를 실행합니다. 따라서 원칙적으로 키가 derive 할 수 있습니다. "그런 것을 보장하는 것"은 다음과 같습니다. 당신이 나를 신뢰하지 않는 경우, 자신의 사본을 실행. - Cloudflare 계정에서. 이것은 아래의 설정 가이드입니다. Cloudflare에서 한 달에 몇 달러의 무료 출발, 그리고 열쇠는 당신이 알고있는 암호에서 온다.
개요(AI 번역)
WhatsApp에 ChatGPT, Claude 또는 Grok를 연결하십시오. 그것은 자신의 메시지 역사, 저장된 암호화 및 오픈 소스를 통해 MCP 서버 만입니다.
전화를 한 번 연결하면 WhatsApp 웹을 연결하고 MCP 클라이언트에서 채팅을 검색하고 읽을 수 있습니다. 그것은 아무것도 보낼 수 없습니다.
@finereli에 의해 건축하는. 질문과 버그 보고서는 여기에 문제가 있거나 X에 나와 있습니다.
그것을 사용하는 2가지 방법이 있습니다:
- ** whatsapp.finereli.com에서 사용하십시오. ** 이것은 빠른 방법입니다. Google과 로그인하여 휴대폰으로 QR 코드를 스캔하고
https://whatsapp.finereli.com/mcp을 에이전트에 추가합니다. 좌석 수와 계정 당 크기 제한을 가진 무료 베타입니다. 귀하의 메시지는 나머지에서 암호화되지만, 로그인 서비스를 실행합니다. 따라서 원칙적으로 키가 derive 할 수 있습니다. "그런 것을 보장하는 것"은 다음과 같습니다. 당신이 나를 신뢰하지 않는 경우, 자신의 사본을 실행. - ** Cloudflare 계정에서 자신의 사본 **를 돌립니다. 이것은 아래의 설정 가이드입니다. Cloudflare에서 한 달에 몇 달러의 무료 출발, 그리고 열쇠는 당신이 알고있는 암호에서 온다. 누구나 다른 사람들을위한 서비스로 실행 할 수 있습니다 : “다른 사람들을 위해 그것을 시도”.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
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/mcpto 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.
설치
npx wrangler kv namespace create OAUTH_KV