GroupMe CLI

Send and read GroupMe messages from the command line using the groupme CLI.

Setup

Installation

git clone https://github.com/cuuush/groupme-cli
cd groupme-cli
npm install
npm run bundle
npm link

> Note: npm run bundle uses esbuild to produce a single self-contained file at dist/groupme-cli.js. No separate TypeScript compilation step needed — just install, bundle, and link.

Authentication

Get your GroupMe API token from dev.groupme.com → Access Token, then configure:

groupme config --token YOUR_ACCESS_TOKEN

Or use the GROUPME_TOKEN environment variable, or pass --token to any command.

Core Commands

List Groups

groupme groups
groupme groups --json

Read Messages

# Latest messages from a group
groupme read --group GROUP_ID

# More messages
groupme read --group GROUP_ID --limit 50

# Paginate older messages
groupme read --group GROUP_ID --before MESSAGE_ID

# JSON output
groupme read --group GROUP_ID --json

Send a Message

groupme send --group GROUP_ID --message "Hello!"

Direct Messages

# Read DMs
groupme dm-read --user USER_ID

# Send a DM
groupme dm --user USER_ID --message "Hey!"

List DM Conversations

groupme chats
groupme chats --page 2 --per-page 10

Current User Info

groupme me

Fuzzy Group Search

Groups support fuzzy name matching — you can use partial names when referencing groups in commands.

Global Options

• --token — Override configured token
• --json — Machine-readable JSON output
• --help — Show help

Tips

• Run groupme groups --json to get GROUP_IDs for use in other commands
• Use --json output to pipe into other tools or for scripting
• Config is stored at ~/.config/groupme/config.json