Skip to content
← Public packages

@kentcdodds/groupme

GroupMe REST API helpers for listing groups, reading messages, ranking activity, and preparing relevance-filtered digests for Kody agents.

FollowFork

ProductivityTopics: groupme, messaging, groups, digest, chat, api

Version
2.1.0
License
MIT
Published
October 19, 2026
Pinned commit
9038fe8
Rating
★ 5.0 (1)
Forks
0
Adaptation effort
1.0

README

Agent docs

@kentcdodds/groupme

Intent

GroupMe REST API helpers for listing groups, reading messages, ranking activity, and preparing relevance-filtered digests for Kody agents. One compact authenticated request helper talks to api.groupme.com/v3; domain helpers rank activity and shape digests. GroupMe does not publish an OpenAPI spec.

What it does

  • Verify OAuth auth and sample recent group activity
  • List groups and rank the most active ones
  • Page or date-window messages for a group
  • Filter messages by keywords, senders, mentions, or attachment types
  • Shape digest input for agent summarization
  • Low-level authenticated request escape hatch for any v3 path

Read-only helpers only — this package does not post messages.

Prerequisites / setup

  1. Connect the groupme OAuth integration (or open the guide export for connect URLs). The package sends that connection's token to GroupMe as the X-Access-Token header. No separate secret is needed.
  2. The connection's allowed hosts include api.groupme.com.
  3. Agents: see AGENTS.md for import paths, smoke-test, and paging limits.

Never paste the access token value into chat or docs.

Done when

  • smoke-test returns { ok: true } with the authenticated user
  • list-groups / list-most-active-groups return expected groups
  • prepare-digest returns a filtered window for a known group name when needed
Report this listing

Log in to report this listing.