chrischall avatar

Signupgenius Mcp

chrischall/signupgenius-mcp

Connects Claude to SignUpGenius for managing volunteer signups, event slots, and groups. Supports three auth modes: Pro API key (required for slot reports showing filled/available participants), direct email/password login (works with free accounts), or cookie passthrough via the fetchproxy extension for zero-config setup. Exposes 13 read tools and 1 write across profiles, groups, signup lists (created/invited/signed-up-for), and participant reports. The session mode hits the same internal API the dashboard uses, so treat this as personal automation for your own account. If you coordinate volunteers through SignUpGenius and want Claude to check signup status, pull rosters, or add group members without opening a browser, this is the bridge.

tools
12
auth
Secret needed
transport
STDIO
env vars
13
last updated
Nov 4, 2026

Tools

12 tools

Public tool metadata for what this MCP can expose to an agent.

signupgenius_get_profileProfile tool in both auth modes.

Profile tool in both auth modes.

No parameter schema in public metadata yet.

signupgenius_list_groups

No parameter schema in public metadata yet.

signupgenius_list_group_members

No parameter schema in public metadata yet.

signupgenius_get_group_member

No parameter schema in public metadata yet.

signupgenius_add_group_memberWrite tool that adds a member to a group, requiring confirmation.

Write tool that adds a member to a group, requiring confirmation.

No parameter schema in public metadata yet.

signupgenius_list_created_active

No parameter schema in public metadata yet.

signupgenius_list_invited

No parameter schema in public metadata yet.

signupgenius_list_signedupfor

No parameter schema in public metadata yet.

signupgenius_legacy_get_my_signupsSession-only sign-up listing that calls the backend used by the SignUpGenius wizard.

Session-only sign-up listing that calls the backend used by the SignUpGenius wizard.

No parameter schema in public metadata yet.

signupgenius_report_allSlot report tool available only in Pro key mode.

Slot report tool available only in Pro key mode.

No parameter schema in public metadata yet.

signupgenius_report_filledSlot report tool available only in Pro key mode.

Slot report tool available only in Pro key mode.

No parameter schema in public metadata yet.

signupgenius_report_availableSlot report tool available only in Pro key mode.

Slot report tool available only in Pro key mode.

No parameter schema in public metadata yet.

Sponsors

Configuration

SIGNUPGENIUS_EMAIL

SignUpGenius login email (recommended). Pair with SIGNUPGENIUS_PASSWORD for session mode — works on free accounts. No SSO/2FA.

SIGNUPGENIUS_PASSWORDsecret

SignUpGenius password (recommended) — required iff SIGNUPGENIUS_EMAIL is set.

SIGNUPGENIUS_USER_KEYsecret

SignUpGenius Pro API key (Pro Tools > API Management). Required only for slot REPORTS — Pro subscription needed.

SIGNUPGENIUS_NAME

Friendly account name used in startup logs.

SIGNUPGENIUS_BASE_URL

Override the default JSON API base (v2/k for key mode, v3 for session mode).

SIGNUPGENIUS_LEGACY_BASE_URL

Session mode only: override the host for legacy /SUGboxAPI.cfm calls. Defaults to https://www.signupgenius.com.

SIGNUPGENIUS_LOGIN_URL

Session mode only: override the login-form host. Defaults to https://www.signupgenius.com.

SIGNUPGENIUS_DISABLE_FETCHPROXY

Set to 1 to skip the fetchproxy browser-extension fallback (missing creds become a hard error — useful in headless CI).

SIGNUPGENIUS_SESSION_CACHE

Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.

SIGNUPGENIUS_SESSION_FILE

Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.signupgenius-mcp/session.json.

FETCHPROXY_WS_PORT

Localhost port of the fetchproxy concentrator the ContextMint Bridge extension connects to (default 37149). Every MCP on one machine shares it, so move it for all of them or not at all.

FETCHPROXY_WS_HOST

Bind interface for the fetchproxy concentrator, a literal IP only (default 127.0.0.1). Keep on loopback; it exists for hosted deployments that run each MCP in its own network namespace.

FETCHPROXY_IDENTITY_DIR

Absolute path where the fetchproxy long-term identity keypair is stored (default ~/.fetchproxy/identity/).

Readme

signupgenius-mcp

CI npm license

MCP server for SignUpGenius. 15 read tools and 4 write across profile, groups, sign-ups, reports, public sign-up metadata, slot listings, RSVPs, and slot claim/release.


View the full README on GitHub

Details

Repository
github.com/chrischall/signupgenius-mcp
Package
signupgenius-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from chrischall