How do I use TeamSnap MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@TeamSnap MCP Server What games do we have scheduled this month?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

TeamSnap MCP Server

A Model Context Protocol (MCP) server that connects Claude to your TeamSnap account. Access your teams, rosters, events, and availability data directly from Claude Desktop or CLI.

Features

Teams: List and view all your TeamSnap teams
Rosters: Get player and coach information
Events: View games, practices, and other events
Availability: Check who's available for events
Secure: OAuth 2.0 authentication with encrypted token storage
AWS Deployment: Optional serverless deployment with permanent HTTPS callback URL

Quick Start

1. Get TeamSnap OAuth Credentials

Go to TeamSnap Developer Portal
Create a new application
Set the redirect URI (see options below)
Note your Client ID and Client Secret

2. Choose Your Deployment

Option A: Local MCP Server

For local development with a tunnel for OAuth callback.

git clone https://github.com/yourusername/TeamSnapMCP.git cd TeamSnapMCP npm install npm run build

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Redirect URI: Use a tunnel like cloudflared tunnel --url http://localhost:8374 for HTTPS callback.

Option B: AWS Serverless (Recommended)

Deploy to AWS Lambda for a permanent HTTPS callback URL with no tunnels needed.

cd aws npm install

Set environment variables:

export AWS_ACCESS_KEY_ID=your-aws-key export AWS_SECRET_ACCESS_KEY=your-aws-secret export AWS_REGION=us-west-2 export TEAMSNAP_CLIENT_ID=your-client-id export TEAMSNAP_CLIENT_SECRET=your-client-secret

Deploy:

node scripts/deploy.cjs

This creates:

API Gateway with permanent HTTPS URL
Lambda function for MCP server
DynamoDB table for token storage

Then use the wrapper for Claude Desktop:

{ "mcpServers": { "teamsnap": { "command": "node", "args": ["/path/to/TeamSnapMCP/dist/wrapper.js"], "env": { "TEAMSNAP_MCP_ENDPOINT": "https://your-api-id.execute-api.us-west-2.amazonaws.com/mcp" } } } }

3. Authenticate

Tell Claude: "Connect to TeamSnap"

A browser will open for OAuth login. Once complete, you're connected!

Available Tools

Tool	Description
`teamsnap_auth`	Connect to TeamSnap
`teamsnap_auth_status`	Check connection status
`teamsnap_logout`	Disconnect from TeamSnap
`teamsnap_list_teams`	List all your teams
`teamsnap_get_team`	Get team details
`teamsnap_get_roster`	Get players and coaches
`teamsnap_get_events`	Get team events
`teamsnap_get_event`	Get event details
`teamsnap_get_availability`	Get event availability

Example Prompts

"What teams do I have in TeamSnap?"
"Show me the roster for the Jr Kraken"
"What games do we have scheduled this month?"
"Who's available for Saturday's game?"

Architecture

┌─────────────────────────────────────────────────────────────┐ │ AWS (Optional) │ │ ┌──────────────┐ ┌──────────────┐ ┌───────────────┐ │ │ │ API Gateway │───▶│ Lambda │───▶│ DynamoDB │ │ │ │ (HTTPS) │ │ (MCP Server) │ │ (Tokens) │ │ │ └──────────────┘ └──────────────┘ └───────────────┘ │ └─────────────────────────────────────────────────────────────┘ ▲ │ HTTP/SSE ▼ ┌───────────┐ ┌───────────────┐ │ Wrapper │◀───────▶│ Claude Desktop│ │ (stdio) │ │ │ └───────────┘ └───────────────┘

Security

OAuth tokens encrypted with AES-256-GCM (local) or stored in DynamoDB (AWS)
Only read access requested from TeamSnap
No credentials stored in code

Development

# Install dependencies npm install # Build npm run build # Run locally node dist/index.js # Run wrapper (connects to AWS) node dist/wrapper.js

License

MIT

TeamSnap MCP Server

TeamSnap MCP Server

Features

Quick Start

1. Get TeamSnap OAuth Credentials

2. Choose Your Deployment

Option A: Local MCP Server

Option B: AWS Serverless (Recommended)

3. Authenticate

Available Tools

Example Prompts

Architecture

Security

Development

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API