@kentcdodds/groupme

@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.

When To Use

• Summarize busy GroupMe groups without reading every message manually.
• Build cast/crew, parent coordination, or team logistics digests from date-bounded windows.
• Rank the most active groups to decide where to focus attention.
• Filter messages by keywords, senders, mentions, or attachment types before agent summarization.
• Verify GroupMe OAuth auth before building custom workflows.

Install

This is a Kody package. After it is saved/published in your Kody account (or forked from the community listing), import it with the kody: specifier:

import listGroups from 'kody:@kentcdodds/groupme/list-groups'

Required setup

• OAuth integration: groupme
• Access token secret: groupmeAccessToken (sent as X-Access-Token)
• Application client id user value: groupme-client-id
• Connect at /connect/oauth?provider=groupme or use the guide export for setup URLs.
• Approve hosts: api.groupme.com, oauth.groupme.com, image.groupme.com

Usage

import prepareDigest from 'kody:@kentcdodds/groupme/prepare-digest'
import listMostActiveGroups from 'kody:@kentcdodds/groupme/list-most-active-groups'
import request from 'kody:@kentcdodds/groupme/request'

const active = await listMostActiveGroups({ limit: 3 })

const digest = await prepareDigest({
  groupName: 'Finding Neverland',
  start: '2026-07-07',
  end: '2026-07-09',
  timeZone: 'America/Denver',
  relevance: {
    keywords: ['rehearsal', 'call time', 'costume'],
    excludeSystem: true,
    minTextLength: 4,
  },
})

// Low-level escape hatch for any v3 path:
const raw = await request({ path: '/users/me', throwOnError: true })

Exports

• ./ — package overview and export discovery metadata.
• ./types — exported TypeScript type name catalog.
• ./request — compact authenticated GroupMe v3 HTTP helper (URL build, secret auth header, JSON parse, errors).
• ./smoke-test — verify auth and sample recent group activity.
• ./guide — connect URL and setup notes ({ origin?: string }).
• ./get-me — authenticated user profile.
• ./list-groups — list groups ({ omitMemberships?, limit?, page? }).
• ./list-messages — one message page ({ groupId, limit?, beforeId? }).
• ./get-messages-in-range — all messages in a date/unix window.
• ./list-most-active-groups — rank groups by recent activity.
• ./filter-relevant-messages — apply a relevance profile to normalized messages.
• ./prepare-digest — fetch, filter, and structure digest input for summarization.

Read-only helpers only; this package does not post messages. get-messages-in-range and prepare-digest stop at maxPages (default 50) to avoid runaway fetches.