MCP server connecting Claude and AI agents to your personal WhatsApp. Search contacts, read messages, send replies and media via natural language.
WhatsApp MCP Server connects AI agents like Claude to your personal WhatsApp account over the Model Context Protocol. With 5,500+ GitHub stars, it supports contact search, message history reading, and sending text and media — all via natural language commands. A Go bridge handles the WhatsApp connection; a Python MCP server exposes tools to the AI agent.
| Tool | Description |
|---|---|
search_contacts |
Search WhatsApp contacts by name |
get_messages |
Fetch message history from any chat |
send_message |
Send text messages to contacts or groups |
send_media |
Send images, documents, and audio files |
Created by lharries. Licensed under MIT.
whatsapp-mcp — ⭐ 5,500+
%20by%20%E2%80%9ELisa%20Wischofsky%E2%80%9D%2C%20licensed%20under%20%E2%80%9ECC0%201.0%E2%80%9D%20(https%3A%2F%2Fcreativecommons.org%2Fpublicdomain%2Fzero%2F1.0%2F)%3C%2Fdc%3Arights%3E%3C%2Frdf%3ADescription%3E%3C%2Frdf%3ARDF%3E%3C%2Fmetadata%3E%3Cmask%20id%3D%22viewboxMask%22%3E%3Crect%20width%3D%22980%22%20height%3D%22980%22%20rx%3D%22490%22%20ry%3D%22490%22%20x%3D%220%22%20y%3D%220%22%20fill%3D%22%23fff%22%20%2F%3E%3C%2Fmask%3E%3Cg%20mask%3D%22url(%23viewboxMask)%22%3E%3Crect%20fill%3D%22url(%23backgroundLinear)%22%20width%3D%22980%22%20height%3D%22980%22%20x%3D%220%22%20y%3D%220%22%20%2F%3E%3Cdefs%3E%3ClinearGradient%20id%3D%22backgroundLinear%22%20gradientTransform%3D%22rotate(295%200.5%200.5)%22%3E%3Cstop%20stop-color%3D%22%23FED7AA%22%2F%3E%3Cstop%20offset%3D%221%22%20stop-color%3D%22%23FFE4CC%22%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Cg%20transform%3D%22translate(10%20-60)%22%3E%3Cpath%20fill-rule%3D%22evenodd%22%20clip-rule%3D%22evenodd%22%20d%3D%22m448%20193%2015%202%209%202c9%201%2017%203%2025%207%208-4%2018-6%2027-7a148%20148%200%200%201%2077%2014%20125%20125%200%200%201%2045%2033l19%204c11%204%2022%209%2032%2016%2010%209%2018%2020%2024%2032l6%2017%201%204v2a232%20232%200%200%200%2034%2070c7%2010%2014%2021%2019%2032%206%2012%2011%2025%209%2039-1%2013-6%2025-16%2034l-3%2015c-4%2011-10%2023-20%2031%203%206%206%2012%207%2019%202%2015%200%2031-7%2045-2%203-4%204-7%205l-1-8-1-5c-2-14-11-27-21-37a47%2047%200%200%201-9%2045c-7%209-18%2016-28%2022-5%202-10%204-15%202l-2-3c-1-2-3-3-3-5-2-7-2-15-2-23v-6c0-16%202-31%204-47-10-4-18-12-24-21-9-12-12-26-13-41-2-30%206-60%2025-84l-6-5-4-4c-18-15-26-35-32-57-3-12-4-26%200-37-4%200-9-1-10-5-1-7%203-14%207-19l-13%207-5%202-10%206c-6%203-12%207-19%209-2%201-4-1-6-2l-5-3c-13-9-26-17-40-23%203%204%206%209%206%2014-1%203-1%206-4%207l-13-1-5-1h-28c-8%2019-12%2038-16%2058a532%20532%200%200%201-29%2091c-8%2017-19%2032-32%2046-8%208-16%2014-25%2020%2018%2011%2030%2028%2039%2046%2017%2033%2029%2068%2031%20105%201%2019-3%2038-11%2055-5%2013-16%2024-29%2030-8%204-18%205-27%205-8-1-15-4-21-8a76%2076%200%200%200-40%207l-1%201c-4%203-8%205-11%2010-5%206-8%2013-10%2021v1c0%202%200%203-2%203-3-5-4-11-4-17%200-9%205-17%209-25l12-11c-5-2-10-5-14-9a69%2069%200%200%201-22-38c-5%201-10%202-15%201-16-1-31-8-42-19-6-6-12-14-16-22l-3-3-2-1-14-17c-9-15-14-33-13-51s6-36%2016-51l11-11c-7-13-12-28-12-43v-12a101%20101%200%200%201%2027-123c10-9%2022-17%2035-18%2014-22%2030-43%2049-60a235%20235%200%200%201%2096-49c22-6%2044-7%2067-5Zm224%2072c13%207%2025%2016%2032%2029%205%2011%207%2022%2010%2033l5%2020a175%20175%200%200%200%2027%2050c8%2012%2016%2024%2022%2036%204%2010%206%2021%204%2032l-7-22c-6-15-14-27-22-41l-1-2-9-12-1-1-6-10-7-10-1-6-1-2a168%20168%200%200%200-45-94Zm-224%2046%2010-25c-14%201-27%203-41%206-8%2015-15%2029-20%2046-6%2023-7%2047-9%2070v6c-1%2018-3%2036-8%2053a201%20201%200%200%200%2047-86l10-32%2010-36%201-2Zm-218%207-11%2029v1l-1%203c-18%2018-31%2044-38%2069a90%2090%200%200%201%2027-86c7-6%2015-12%2023-16Zm-52%20220c3-10%208-19%2015-27l-9%209a88%2088%200%200%200-6%2084l-3-27c-1-13-1-26%203-39Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20d%3D%22M495%20234c28%201%2056%206%2084%2015a201%20201%200%200%201%20100%2065c19%2025%2031%2055%2035%2086a361%20361%200%200%201%202%20101l-5%2034-4%2020c-1%202-1%202-3%202-2-4-2-8-2-12-1-15%201-29%202-44%201-24%203-48%201-72l-6-45c-7-28-20-54-40-75-18-18-40-33-63-43-22-9-44-15-67-19-18-3-36-4-54-4a277%20277%200%200%200-128%2029c-13%209-25%2020-35%2032a276%20276%200%200%200-55%20139c-1%2024%200%2047%208%2070l7%2015%2012%201%201%203c-3%202-7%202-11%203-10%202-20%206-29%2012-7%205-14%2011-18%2019-5%2010-3%2022-1%2033%205%2019%2017%2037%2033%2049%2011%209%2025%2014%2039%2016%2010%202%2020%200%2030-1%205%204%208%2012%2011%2017l18%2027a136%20136%200%200%200%2066%2050c22%209%2045%2014%2068%2019l41%208%2017%205v4h-12a535%20535%200%200%201-67-8%20255%20255%200%200%201-84-33c-11-7-21-16-29-27a214%20214%200%200%201-16%20123c-15%2027-40%2048-70%2057-3%201-7%202-10%201-2%200-2-1-2-3%201-3%204-5%206-6%2012-8%2026-14%2038-23%2013-11%2024-23%2031-38%206-15%2010-32%2012-49%202-13%203-26%202-40l-4-38-18-36-19%204a88%2088%200%200%201-75-38%2093%2093%200%200%201-20-58c0-9%203-18%208-25s12-13%2019-17c5-4%2012-6%2018-8l-9-24c-5-22-5-45-2-67a292%20292%200%200%201%2063-149c9-10%2018-19%2029-26%207-4%2014-5%2020-9%2043-19%2090-25%20137-22Z%22%20fill%3D%22%23000%22%2F%3E%3Cpath%20d%3D%22M475%20243a276%20276%200%200%201%20121%2023c23%2010%2045%2025%2063%2043%2020%2021%2033%2047%2040%2075l6%2045c2%2024%200%2048-1%2072-1%2015-3%2029-2%2044%200%204%200%208%202%2012l-1%2020c-2%205-2%2010-2%2016-2%2024-2%2049-6%2074-1%2012-3%2025-8%2036-3%209-8%2017-15%2024-12%2013-27%2024-43%2033-19%2011-39%2016-58%2024-5%202-10%204-13%208%208%201%2015%200%2023-2-5%2012-6%2024-6%2036%200%205-1%2011%201%2016%203%205%208%209%2013%2012l35%2013c22%208%2043%2018%2065%2027%202%204%205%207%206%2012%206%2011%207%2023%203%2035-5%2013-15%2024-27%2031-16%2011-36%2019-55%2024a494%20494%200%200%201-235-7c-20-7-40-14-58-24-14-8-29-18-40-31-6-8-11-19-12-29a122%20122%200%200%200%2086-107c4-24%204-49%200-73%208%2011%2018%2020%2029%2027l27%2014a331%20331%200%200%200%20124%2027h12v-4l-17-5-41-8c-23-5-46-10-68-19-13-6-27-13-39-21-10-9-19-18-27-29l-18-27c-3-5-6-13-11-17-10%201-20%203-30%201-14-2-28-7-39-16a94%2094%200%200%201-33-49c-2-11-4-23%201-33%204-8%2011-14%2018-19%209-6%2019-10%2029-12%204-1%208-1%2011-3l-1-3-12-1-7-15c-8-23-9-46-7-70a276%20276%200%200%201%2054-139c10-12%2022-23%2035-32a277%20277%200%200%201%20128-30Z%22%20fill%3D%22%23ffffff%22%2F%3E%3Cpath%20d%3D%22M260%20571c4%200%207%200%2011%202%205%201%2011%204%2014%208%202%203%202%207%200%2010-5%206-12%2010-16%2016%206%204%2014%206%2021%209%204%201%208%203%2011%206l1%203-8-2-24-7c-4-1-8-3-9-7-1-3%201-7%203-10l15-13c-4-7-15-8-19-15ZM703%20577l2%203%202%2016a483%20483%200%200%201-2%2089c-2%2011-5%2023-10%2033a198%20198%200%200%201-106%2071c-1%2014-3%2031-2%2047l5%205c8%206%2018%209%2027%2012a451%20451%200%200%201%2068%2028c7%204%2013%209%2018%2015-5%201-10-1-16-2-22-9-43-19-65-27l-35-13c-5-3-10-7-13-12-2-5-1-11-1-16%200-12%201-24%206-36-8%202-15%203-23%202%203-4%208-6%2013-8%2019-8%2039-13%2058-24%2016-9%2031-20%2043-33%207-7%2012-15%2015-24%205-11%207-24%208-36%204-25%204-50%206-74%200-6%200-11%202-16Z%22%20fill%3D%22%23000%22%2F%3E%3Cpath%20d%3D%22M681%20473c6%202%2012%207%2015%2013%202%203%202%206%200%209-2%204-8%206-12%203-4-2-6-6-9-9-7-3-13-2-19%200%203%203%206%206%207%2010%204%2012%203%2025-2%2036l10-5c0%204%200%207-2%2011-5%206-13%2010-20%2011-9%201-17%202-25-2-4-3-5-7-5-11l-2-10c0-7%203-13%206-19%207-14%2018-26%2031-33%208-4%2018-6%2027-4ZM456%20484c27%201%2053%2017%2065%2041%202%203%203%206%201%2010-3-1-4-3-6-6-6-9-13-17-22-23-10-6-22-9-34-9%206%2010%209%2021%208%2032-1%209-4%2019-12%2026%204%201%207%202%209%204-6%203-13%203-20%201-9-2-17-6-25-11-8-6-16-13-20-23l-4-8c-2-4-1-8%202-11l10-9c14-10%2031-15%2048-14Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20d%3D%22M533%20358c6%202%209%208%2010%2014%200%208-3%2016-7%2022-3%203-7%204-10%201-4-3-2-10-2-15l-13%2010c-6%204-13%207-20%209-9%204-19%205-30%208l-25%208c-8%203-15%208-22%2012l-25%2017c-5%203-8%207-11%2012-2-4-1-8%201-11a401%20401%200%200%201%2035-29c16-13%2036-21%2055-28l28-11c8-4%2014-11%2021-16%205-2%2010-4%2015-3ZM626%20376l6%207c17%207%2033%207%2049%2016%204%202%207%206%209%2010s1%208-2%2012l-16-6c-12-6-24-7-36-11-7-3-14-4-19-10-4%208-4%2017-8%2026-1%201-1%204-4%203l-1-8%202-11c1-8%204-16%207-23%202-6%208-8%2013-5Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20d%3D%22M603%20613v1c-4%208-11%2015-20%2018-3%201-7%201-9-1v-4c7-5%2016-9%2024-12l5-2Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20d%3D%22M513%20669c0%207-5%2015-8%2021%2023-1%2045%202%2067-2%2020-3%2037-11%2056-14%204%200%2010-2%2014%202-3%205-8%206-13%208-9%205-19%207-29%2011-10%202-19%205-29%206-16%202-32%200-48-1l-21-4-10%2023c-1%202-4%203-6%201v-8c3-12%2010-24%2016-35l7-11c3-1%205%200%204%203Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20fill-rule%3D%22evenodd%22%20clip-rule%3D%22evenodd%22%20d%3D%22M468%20196a218%20218%200%200%200-234%20122%20323%20323%200%200%200-25%20186l4%2019c1%203%203%206%205%206l4%201h1c5%206%2012%2010%2020%2012%2012%204%2026%204%2038%202-3%2016%201%2034%207%2049%205%2012%2013%2025%2023%2034a67%2067%200%200%200%2051%2014c5-1%209-4%2013-8v-1l2-5h-3c-3%200-5%200-8-2-11-6-19-17-25-28-10-20-15-43-15-65%2013-6%2024-16%2033-27l7-5%204-2c9-6%2017-14%2025-22%2017-20%2030-43%2039-67a443%20443%200%200%200%2016-63c4-20%208-41%2017-60a185%20185%200%200%201%2034%201l12%201c3-1%204-4%204-7%200-5-3-10-6-14a272%20272%200%200%201%2045%2026c2%202%205%203%207%202a172%20172%200%200%200%2026-13l6-4%2014-7c-3%205-7%2012-7%2018%200%203%203%205%206%205%2011%201%2021-1%2032-4l4-1c4-1%208%202%2011%204%209%209%2015%2022%2016%2034a118%20118%200%200%201%200%2035l-1%2011-1%2015-2%2037c2%2016%208%2032%2020%2043%209%209%2022%2012%2034%209%206-2%2012-6%2016-10%205-4%207-9%207-16l-11%204-14%204v-8c4-3%208-7%2010-11l-2-9-1-7-3-23-3-25-1-7c-2-14-4-27-9-41a162%20162%200%200%200-42-68c-6-4-11-7-18-9a136%20136%200%200%200-39-36c-17-8-34-14-52-17-15-2-32-3-46%201l-16%205c-9-4-19-6-29-8Zm-20%20115c3-8%205-17%2010-25-14%201-27%203-41%206-7%2013-14%2027-18%2041a232%20232%200%200%200-10%2071c-2%2021-3%2043-9%2063%2019-20%2034-45%2042-71%206-15%2010-30%2014-46%204-13%207-26%2012-38v-1Z%22%20fill%3D%22%23000000%22%2F%3E%3C%2Fg%3E%3Cg%20transform%3D%22translate(10%20-60)%22%3E%3Cpath%20d%3D%22M357%20396c9-2%2018%204%2020%2012%201%205%201%2012-1%2017-3%207-11%2010-18%209-9%200-16-9-16-18%200-4%202-7%203-11%203-4%208-8%2012-9Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20d%3D%22M358%20405c7-2%2012%203%2013%209%202%208-5%2015-13%2014-7-2-11-10-8-17%202-3%205-5%208-6Z%22%20fill%3D%22%23fff%22%2F%3E%3Cpath%20fill-rule%3D%22evenodd%22%20clip-rule%3D%22evenodd%22%20d%3D%22M326%20398c-2-4-5-7-9-9-5-1-10%201-14%203-4%201-7%204-9%207-11-4-23%200-30%2010-3-4-6-7-10-9-3-1-6%200-9%201l-4%201c-6%201-12%203-16%209-4%207-4%2016%200%2023%202%205%206%208%2011%2010-7%201-13%205-17%2011l-2-1-9-3c-6%200-12%202-17%206-4%204-8%208-10%2013-2%207-1%2013%201%2020-9%208-13%2021-6%2032%204%207%2010%209%2017%2011%205%201%2011%201%2016-1%202%206%206%2012%2011%2015%206%203%2014%204%2021%201%205-1%2010-3%2013-8%203-3%203-8%204-12%205-2%209-3%2013-7%205-4%209-10%2010-16s0-12-2-17c-3-6-9-10-15-12%201-5%202-9%201-14l6%202c2%206%204%2011%208%2015%207%205%2015%207%2023%206%206%200%2011-4%2014-9%202-3%203-7%203-11h1c7%201%2014%201%2019-4%207-6%209-18%206-27-3-8-9-11-17-14%202-7%202-15-2-22Zm-70%2051%202-10-10%206%208%204Z%22%20fill%3D%22%23000000%22%2F%3E%3Cpath%20d%3D%22M236%20409c3-2%207-2%2010-2%207%202%2012%209%2011%2016%200%206-3%2011-8%2014-9%205-22-2-22-13%200-6%204-13%209-15ZM309%20398c5%200%2010%203%2012%208%204%206%203%2014%201%2022%206%202%2010%206%2012%2012%203%205%201%2012-3%2016-5%204-11%205-17%204-2%207-7%2013-14%2016-5%201-11%200-15-4-5-4-7-10-8-16-4-1-7-1-10-4-5-4-5-12-2-17l8-6c-3-4-5-10-4-15s4-9%209-10c6-1%2011%201%2016%205%204-6%208-11%2015-11ZM257%20460c2%208%200%2016-3%2023%205%200%209%201%2013%204%205%204%207%209%207%2015%201%205-1%2010-6%2013-5%204-12%205-18%205%201%205%202%2010-1%2014-5%207-15%208-22%205-6-3-10-9-12-16-6%202-13%203-19%202-5-1-9-4-11-8-4-5-4-12%200-17l10-7c-4-7-7-17-4-25%201-5%206-9%2012-8%206%200%2012%203%2017%207%203-7%208-14%2016-16%208-3%2018%200%2021%209Z%22%20fill%3D%22%23fff%22%2F%3E%3C%2Fg%3E%3C%2Fg%3E%3C%2Fsvg%3E){kind=small}