Which integrations are available for this server?

Provides tools for interacting with the GroupMe API v3, allowing AI assistants to manage groups and members, read and send messages, interact with bots, and handle likes and direct messages.

How do I use groupme-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@groupme-mcp Show me the latest messages from my Family group" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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 run with --directory pointing to a local clone instead of uvx.

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