groupme-mcp
A Model Context Protocol (MCP) server that wraps the GroupMe API v3, letting AI assistants read and send GroupMe messages, manage groups, interact with bots, and more.
Tools
| Category | Tools |
|---|---|
| Groups | list_groups, list_former_groups, get_group, create_group, update_group, destroy_group, join_group, rejoin_group |
| Members | add_members, get_member_results, remove_member, update_membership |
| Messages | list_messages, send_message |
| Direct Messages | list_direct_messages, send_direct_message |
| Chats | list_chats |
| Likes | like_message, unlike_message |
| Bots | create_bot, post_as_bot, list_bots, destroy_bot |
| Users | get_me, update_user |
| Blocks | list_blocks, check_block, create_block, delete_block |
Requirements
- Python 3.12+
- A GroupMe access token — get one at dev.groupme.com
Usage
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"groupme": {
"command": "uvx",
"args": ["groupme-mcp"],
"env": {
"GROUPME_TOKEN": "<your-token>"
}
}
}
}
Until published to PyPI, use
uv runwith--directorypointing to a local clone instead ofuvx.
Local development
git clone https://github.com/KalebJS/groupme-mcp
cd groupme-mcp
export GROUPME_TOKEN=<your-token>
uv run mcp dev main.py # opens MCP Inspector in browser
Development
# Install dev dependencies
uv sync --group dev
# Install pre-commit hooks
uv run --group dev pre-commit install
# Run tests
uv run --group dev pytest tests/ -v
# Lint
uv run --group dev pre-commit run --all-files
License
MIT