FW

finereli/whatsapp-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

396 stars 35 forks 品質 70 トレンド 64MIT

自分のAIエージェントの検索と独自のWhatsAppメッセージを読むことを可能にする読み取り専用MCPサーバー。 whatsapp.finereli.comで無料で使用したり、Cloudflareで独自のコピーを実行したりできます.

概要

ChatGPT、Claude、またはGrkをWhatsAppに接続します。 自分のメッセージ履歴、保存された暗号化された、およびオープンソースの読み取り専用のMCPサーバーです。 WhatsApp Webをリンクし、MCP クライアントからチャットを検索して読むことができます。 何も送信できません。 @finereliによって造られる。 質問とバグ報告は、ここでの問題、またはXで私に行きます。 - これは簡単な方法です。 Googleでサインインし、お使いの携帯電話でQRコードをスキャンし、https://whatsapp.finereli.com/mcp]をエージェントに追加します。 限られた席数とアカウントごとにサイズ制限が付いた無料ベータです。 あなたのメッセージは残りで暗号化されますが、私はログインサービスを実行しますので、原則として私はあなたのキーを導き出すことができます。 「それが保証するもの」は、その意味を正確に言う。 信頼していない場合は、自分のコピーを実行してください。 - クラウドフレアアカウントで。 カバーのセットアップガイドです。 Cloudflareの月額わずか数ドルから離れて、鍵はパスワードのみから入手できます.

概要(AI 翻訳)

ChatGPT、Claude、またはGrkをWhatsAppに接続します。 自分のメッセージ履歴、保存された暗号化された、およびオープンソースの読み取り専用のMCPサーバーです。

WhatsApp Webをリンクし、MCP クライアントからチャットを検索して読むことができます。 何も送信できません。

@finereliによって造られる。 質問とバグ報告は、ここでの問題、またはXで私に行きます。

2つの方法があります。

  • whatsapp.finereli.comで使用して下さい。 これは簡単な方法です。 Googleでサインインし、お使いの携帯電話でQRコードをスキャンし、https://whatsapp.finereli.com/mcp]をエージェントに追加します。 限られた席数とアカウントごとにサイズ制限が付いた無料ベータです。 あなたのメッセージは残りで暗号化されますが、私はログインサービスを実行しますので、原則として私はあなたのキーを導き出すことができます。 「それが保証するもの」は、その意味を正確に言う。 信頼していない場合は、自分のコピーを実行してください。
  • 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/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.
GitHub で README 全文を見る

インストール

npx wrangler kv namespace create OAUTH_KV
MCP 初心者?mcpskill.org のガイドから始めましょう →