beepctl
Use when sending messages, searching chats, or managing conversations across messaging platforms (Telegram, WhatsApp, Slack, iMessage, etc.) via Beeper Desktop API.
Install
mkdir -p .claude/skills/beepctl && curl -L -o skill.zip "https://mcp.directory/api/skills/download/6758" && unzip -o skill.zip -d .claude/skills/beepctl && rm skill.zipInstalls to .claude/skills/beepctl
About this skill
beepctl
CLI for Beeper Desktop API — unified messaging from your terminal. Control all your messaging platforms (Telegram, WhatsApp, Slack, iMessage, etc.) through one interface.
📖 Setup & installation: see GitHub repo
Quick Start
beepctl accounts # List connected accounts
beepctl chats list # List recent chats
beepctl chats list --search "John" # Find a chat
beepctl search "meeting" --after "1d ago" # Search messages
beepctl send <chat-id> "Hello!" # Send a message
Commands
Auth Management
beepctl auth show # Check auth status and token
beepctl auth set <token> # Set API token
beepctl auth clear # Clear saved token
Accounts
beepctl accounts # List all connected accounts
Browse Chats
beepctl chats list # List inbox (non-archived)
beepctl chats list --limit 20 # Limit results
beepctl chats list --search "John" # Filter by name
beepctl chats list --inbox archive # Archived chats only
beepctl chats list --inbox low-priority # Low-priority chats
beepctl chats list --inbox all # All chats
beepctl chats list --type group # Filter by type (single/group/any)
beepctl chats list --unread-only # Unread chats only
beepctl chats list --activity-after "1d ago" # Recent activity filter
beepctl chats show <chat-id> # Detailed chat info with participants
beepctl chats create <account> <users...> # Create new chat
Inbox filters: primary (default), archive, low-priority, all
List Messages
beepctl messages <chat-id> # Recent messages from a chat
beepctl messages <chat-id> --limit 10 # Limit results
beepctl messages work --after "1d ago" # Use alias + time filter
beepctl messages <chat-id> --before "1h ago" # Messages before a time
Search Messages
beepctl search "query" # Search across all chats
beepctl search "query" --limit 10 # Limit results
beepctl search "meeting" --after "1d ago" # Time filter
beepctl search "hello" --chat work # Filter by chat/alias
beepctl search "files" --media file # Filter by media type
beepctl search "dm" --chat-type single # Filter by chat type
beepctl search "update" --sender others # Filter by sender (me/others)
beepctl search "msg" --account <id> # Filter by account
beepctl search "todo" --include-low-priority # Include low-priority chats
beepctl search "important" --exclude-muted # Exclude muted chats
Combine filters:
beepctl search "deploy" --chat work --sender others --after "1d ago" --media link
beepctl search "hello" --chat work family # Multiple chats (space-separated)
beepctl search "test" --chat id1,id2,id3 # Multiple chats (comma-separated)
Time formats: 1h ago, 2d ago, 3w ago, 1mo ago, yesterday, today
Media types: any, video, image, link, file
Aliases
Create shortcuts for frequently used chat IDs:
beepctl alias list # List all aliases
beepctl alias add work <chat-id> # Create alias
beepctl alias show work # Show alias value
beepctl alias remove work # Remove alias
beepctl send work "Using alias!" # Use alias in any command
Archive Chats
beepctl archive <chat-id> # Archive a chat
beepctl archive <chat-id> --unarchive # Unarchive
beepctl archive work # Use alias
beepctl archive <chat-id> --quiet # No confirmation message
Send Messages
⚠️ NEVER send messages without explicit user approval first! Always show the message content and recipient, then ask for confirmation.
beepctl send <chat-id> "Hello!" # Send message
beepctl send myself "Quick note" # Send to self
beepctl send <chat-id> "Reply" --reply-to <msg-id> # Reply to message
beepctl send <chat-id> "msg" --quiet # No confirmation output
Focus (Bring to Foreground)
beepctl focus # Bring Beeper to foreground
beepctl focus <chat-id> # Open a specific chat
beepctl focus <chat-id> -m <msg-id> # Jump to specific message
beepctl focus <chat-id> -d "draft" # Pre-fill draft text
beepctl focus <chat-id> -a /path/file # Pre-fill draft attachment
Send Media
beepctl send only supports text. To send media, use focus with draft:
beepctl focus <chat-id> -a /path/to/image.png -d "Caption"
# Then press Enter in Beeper to send
Contacts
beepctl contacts search <account> <query> # Search contacts on an account
Download Attachments
beepctl download <mxc-url> # Download attachment (mxc:// URLs)
beepctl download <mxc-url> -o /path # Save to specific path
Reminders
beepctl reminders set <chat> 30m # Remind in 30 minutes
beepctl reminders set <chat> 1h # Remind in 1 hour
beepctl reminders set <chat> 2d # Remind in 2 days
beepctl reminders set <chat> tomorrow # Remind tomorrow
beepctl reminders clear <chat> # Clear reminder
Tips
- Chat IDs look like:
!gZ42vWzDxl8V0sZXWBgO:beeper.local - Use aliases to avoid typing long chat IDs
- The special alias
myselfsends to your own chat
More by openclaw
View all skills by openclaw →You might also like
flutter-development
aj-geddes
Build beautiful cross-platform mobile apps with Flutter and Dart. Covers widgets, state management with Provider/BLoC, navigation, API integration, and material design.
drawio-diagrams-enhanced
jgtolentino
Create professional draw.io (diagrams.net) diagrams in XML format (.drawio files) with integrated PMP/PMBOK methodologies, extensive visual asset libraries, and industry-standard professional templates. Use this skill when users ask to create flowcharts, swimlane diagrams, cross-functional flowcharts, org charts, network diagrams, UML diagrams, BPMN, project management diagrams (WBS, Gantt, PERT, RACI), risk matrices, stakeholder maps, or any other visual diagram in draw.io format. This skill includes access to custom shape libraries for icons, clipart, and professional symbols.
ui-ux-pro-max
nextlevelbuilder
"UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 8 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient."
godot
bfollington
This skill should be used when working on Godot Engine projects. It provides specialized knowledge of Godot's file formats (.gd, .tscn, .tres), architecture patterns (component-based, signal-driven, resource-based), common pitfalls, validation tools, code templates, and CLI workflows. The `godot` command is available for running the game, validating scripts, importing resources, and exporting builds. Use this skill for tasks involving Godot game development, debugging scene/resource files, implementing game systems, or creating new Godot components.
nano-banana-pro
garg-aayush
Generate and edit images using Google's Nano Banana Pro (Gemini 3 Pro Image) API. Use when the user asks to generate, create, edit, modify, change, alter, or update images. Also use when user references an existing image file and asks to modify it in any way (e.g., "modify this image", "change the background", "replace X with Y"). Supports both text-to-image generation and image-to-image editing with configurable resolution (1K default, 2K, or 4K for high resolution). DO NOT read the image file first - use this skill directly with the --input-image parameter.
fastapi-templates
wshobson
Create production-ready FastAPI projects with async patterns, dependency injection, and comprehensive error handling. Use when building new FastAPI applications or setting up backend API projects.
Related MCP Servers
Browse all servers
Apple Native ToolsBoost productivity on macOS with Apple Native Tools—search contacts, manage notes, and message easily in your favorite p
LinkedIn APIBridge AI with the LinkedIn API to auto connect, manage profiles, and integrate with Pipedrive for powerful prospecting
LinkedIn APILeverage LinkedIn API to automate connections, search profiles, manage posts, and enhance sales or recruitment using pow
DingDing BotDingDing Bot lets you send text and markdown messages to DingDing group chats via custom webhooks, enabling automated, f
Mac MessagesUse Mac Messages, the top iMessage app for PC, to send and read iMessages from your desktop with contact and group chat
Microsoft TeamsIntegrate Microsoft Teams with Microsoft Graph API to manage chats, messages, and users securely using device code authe
Stay ahead of the MCP ecosystem
Get weekly updates on new skills and servers.