TeamSnap

Queries TeamSnap data: teams, rosters, events, and availability via an OAuth-protected MCP server.

javascript

1

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mrelph-teamsnapmcp": {
      "command": "node",
      "args": [
        "/path/to/TeamSnapMCP/dist/index.js"
      ],
      "env": {
        "TEAMSNAP_CLIENT_ID": "your-client-id",
        "TEAMSNAP_REDIRECT_URI": "https://your-tunnel-url/callback",
        "TEAMSNAP_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

This MCP server lets Claude access your TeamSnap data by connecting securely to your TeamSnap account. You can list teams, view rosters, pull events, and check availability directly from Claude Desktop or CLI, with OAuth protection and options for local or cloud deployment.

How to use

Connect to TeamSnap from your MCP client to start querying data. Once connected, you can list teams, fetch rosters, retrieve events, and check who is available for upcoming games or practices. The server authenticates using OAuth 2.0 and stores tokens securely. If you choose the AWS deployment path, you’ll get a permanent HTTPS callback URL and a wrapper that connects Claude Desktop to the cloud-hosted MCP server.

How to install

Prerequisites: Node.js and npm installed on your machine.

Clone the MCP server repository and install dependencies.

Available tools

teamsnap_auth

Connect to TeamSnap and initiate the OAuth flow to authorize access.

teamsnap_auth_status

Check whether the MCP server is currently connected to TeamSnap.

teamsnap_logout

Disconnect from TeamSnap and revoke the stored tokens.

teamsnap_list_teams

List all teams available in your TeamSnap account.

teamsnap_get_team

Retrieve detailed information for a specific team.

teamsnap_get_roster

Fetch players and coaches for a team.

teamsnap_get_events

Get upcoming and past events for a team.

teamsnap_get_event

Retrieve details for a specific event.

teamsnap_get_availability

Check availability for team members for events.