beeper-cliSearch chats, list/read messages, and send messages via Beeper Desktop using the beeper-cli.
Install via ClawdBot CLI:
clawdbot install foeken/beeper-cliRequires:
Use this skill when you need to search chats, list/read messages, or send messages via Beeper Desktop.
A CLI wrapper around the Beeper Desktop API. No MCP, no curl — just beeper commands.
Requires beeper-cli.
BEEPER_ACCESS_TOKEN set (get from Beeper Desktop: Settings > Developers > API Access Token)Download from releases, or build:
go install github.com/foeken/beeper-cli@latestbeeper accounts list
beeper accounts list -o table# List all chats (sorted by last activity)
beeper chats list
# Search chats
beeper chats search --query "John"
beeper chats search --query "project" --type group
# Get specific chat
beeper chats get "<chatID>"
# Archive
beeper chats archive "<chatID>"
# Create
beeper chats create --account-id "telegram:123" --participant "user1" --type dm
# Reminders
beeper chats reminders create "<chatID>" --time "2025-01-26T10:00:00Z"
beeper chats reminders delete "<chatID>"# List messages in a chat
beeper messages list "<chatID>"
# Search messages
beeper messages search --query "dinner"
beeper messages search --query "dinner" --limit 10
beeper messages search --query "meeting" --sender me
beeper messages search --query "budget" --after "2025-01-01T00:00:00Z"
beeper messages search --chat-ids "<chatID>" --media-type image
# Send a message
beeper messages send "<chatID>" "Hello!"
# Send with reply
beeper messages send "<chatID>" "Thanks!" --reply-to "<messageID>"
# Edit a message
beeper messages edit "<chatID>" "<messageID>" "Corrected text"# Upload a file
beeper assets upload /path/to/image.png
# Download an asset
beeper assets download "mxc://beeper.local/abc123" --output /path/to/save.jpg
# Send with attachment (upload first)
beeper assets upload /path/to/photo.jpg # returns uploadID
beeper messages send "<chatID>" "Check this!" --upload-id "<uploadID>"# Focus Beeper window
beeper focus
beeper focus --chat-id "<chatID>"
# Global search
beeper search "important"beeper chats list -o json # default
beeper chats list -o table # human-readablebeeper chats search --query "Name"beeper messages list "" beeper messages search --query "phrase"beeper messages send "" "message" BEEPER_ACCESS_TOKEN securely (e.g., in a password manager)Generated Mar 1, 2026
Support agents can search for past conversations with a customer to understand context before responding. They can quickly send follow-up messages or reminders about unresolved issues, ensuring timely and informed support.
Project managers can search group chats for specific discussions about tasks or deadlines. They can send updates or reminders to team members, facilitating efficient communication and keeping projects on track.
Sales representatives can search for leads or past interactions with clients to personalize outreach. They can send targeted messages or schedule follow-ups, enhancing engagement and conversion rates.
Content creators can search for feedback or drafts shared in chats. They can send revised versions or attachments for review, streamlining the collaboration process and improving content quality.
IT staff can search for reported issues in chat histories to track problems. They can send status updates or request additional information, improving response times and resolution efficiency.
Offer a basic version of beeper-cli for free with core features like message search and sending. Charge for advanced capabilities such as bulk operations, analytics, or premium support, targeting power users and small businesses.
Provide customized integrations of beeper-cli with existing business systems like CRM or project management tools. Offer consulting and support services to help companies automate workflows and enhance team communication.
Develop training courses and certifications for using beeper-cli in professional settings. Target IT departments and remote teams, offering workshops and materials to improve productivity and security practices.
💬 Integration Tip
Set up the BEEPER_ACCESS_TOKEN as an environment variable in your system's shell profile to avoid manual entry for each session.
iMessage/SMS CLI for listing chats, history, watch, and sending.
Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).