beeper

Search and read messages from Beeper Desktop API (WhatsApp, Signal, Telegram, etc.).Triggers: "check my messages", "search messages", "who messaged me", "find conversations","unread messages", "beeper", "chat history".

⭐30stars🔀1forks📁View on GitHub🕐Updated Jan 9, 2026⬇️8downloads

When & Why to Use This Skill

The Beeper skill empowers Claude to interface directly with the Beeper Desktop API, serving as a unified gateway for managing cross-platform communications. It allows users to search, retrieve, and monitor messages from various networks like WhatsApp, Signal, Telegram, and Instagram through a single AI-driven interface, significantly reducing the need for app-switching and improving message discoverability.

Use Cases

  • Unified Message Monitoring: Quickly check for unread messages across all connected chat networks (WhatsApp, Signal, Telegram, etc.) to stay updated without manual checking.
  • Global Chat Search: Locate specific information, such as shared links, dates, or instructions, by performing a keyword search across the entire history of all integrated messaging platforms.
  • Contextual Briefing: Retrieve and summarize recent conversation history with a specific contact to gain context before a meeting or when responding to complex inquiries.
  • Contact Discovery: Find specific chat IDs and conversation details across different platforms using simple name-based queries.
namebeeper
description|
Triggers"check my messages", "search messages", "who messaged me", "find conversations",

Beeper Desktop API

Use the beeper CLI to access messages across chat networks (WhatsApp, Signal, Telegram, Instagram, etc.).

Commands

# List/search chats
beeper chats
beeper chats -q "John"
beeper chats --unread

# Search messages across all chats
beeper search "meeting tomorrow"

# Get messages from a specific chat (use chat ID from chats command)
beeper messages "!chatID:beeper.local"

# Get a single chat's details
beeper chat "!chatID:beeper.local"

Tips

Chat IDs start with "!" - the CLI handles URL encoding automatically. Pipe to jq to filter JSON output. Search returns matching chats in the "chats" field.

$ARGUMENTS