Skip to main content
Glama
oddrationale

groupme-mcp-server

by oddrationale

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FASTMCP_LOG_LEVELNoVerbosity of FastMCP's own fastmcp.* loggers.INFO
GROUPME_LOG_LEVELNoVerbosity of the server's own loggers: DEBUG, INFO, WARNING, ERROR, or CRITICAL.INFO
OTEL_SDK_DISABLEDNoSet to true/1 to keep tracing off even when an endpoint is set.
OTEL_SERVICE_NAMENoThe service.name resource attribute on exported spans.groupme-mcp-server
GROUPME_ACCESS_TOKENYesGroupMe API token from https://dev.groupme.com. Optional at startup; required when a tool calls the API.
GROUPME_API_BASE_URLNoGroupMe REST API base URL (override mainly for testing).https://api.groupme.com/v3
GROUPME_IMAGE_API_BASE_URLNoGroupMe image-upload service base URL. Reserved: unused until image upload is implemented.https://image.groupme.com
OTEL_EXPORTER_OTLP_HEADERSNoExtra headers for the OTLP exporter (e.g. authorization=Bearer%20...).
OTEL_EXPORTER_OTLP_ENDPOINTNoOTLP/HTTP collector endpoint. Setting it turns tracing on.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_conversationsA

List the user's GroupMe conversations, most recently active first.

Use this first, whenever you need to find a conversation or the ids the other tools take: it merges groups and direct-message chats into one recency-sorted list with last-message previews and member counts. Every entry carries the group_id or other_user_id that read_messages and get_conversation_context need.

read_messagesA

Read messages from one GroupMe conversation, oldest first.

Use this to read or page through the history of a specific group or direct-message chat once you know its id (from list_conversations). Sender names are resolved and attachments are normalized (image URLs, reply/mention summaries). An empty page is a normal answer, not an error: it means the conversation has no messages in the requested range.

get_conversation_contextA

Get one group's metadata, member list, and recent messages in one call.

Use this to orient yourself in a group before reading further or replying: it bundles what would otherwise take several calls. For direct-message chats or for paging deeper into history, use read_messages instead.

search_messagesA

Search one conversation's message history for matching messages.

Use this to find specific messages ("who mentioned pizza?", "what did Ada say last week?") instead of paging manually with read_messages. GroupMe has no search API, so this scans backwards from the newest message, matching query against message text and sender_name against sender names (both case-insensitive substrings), until limit matches are found, the oldest message is reached, or max_messages_scanned messages have been examined. The result reports exactly how far the scan got — check oldest_message_reached and note before concluding something was never said.

get_highlightsA

Summarize what mattered in a group: its most-liked recent messages.

Use this to catch up on a busy group without reading everything: it wraps GroupMe's likes leaderboard into the period's top-liked messages (sender, like count, text preview) plus a per-member summary of who was most liked and most represented among them. The member summary covers only the leaderboard's messages, not the group's full history. The leaderboard endpoint is undocumented; if GroupMe has retired it, this tool fails with guidance rather than guessing.

send_messageA

Send a message to a GroupMe group or direct-message chat.

Use this to post as the authenticated user once you know where to send (ids come from list_conversations). Each call sends a new message — calling twice posts twice. To reply to a specific message, pass its id (from read_messages) as reply_to_message_id.

react_to_messageA

Like a GroupMe message, or remove your like from one.

Use this to react to a specific message on the authenticated user's behalf — acknowledging something without posting a reply. Both actions are idempotent: liking an already-liked message (or unliking one you never liked) leaves it in the requested state. Ids come from read_messages with response_format="detailed": use its conversation_id (a group id, or a composite direct-chat id like "123+456") and message id.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/oddrationale/groupme-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server