MCP Connector
The MCP Connector lets external AI tools read your Sequence training data through the Model Context Protocol. This enables AI assistants and other MCP-compatible clients to access your activities, training sessions, and goals in a secure, read-only way.
The MCP Connector is a feature that must be enabled for your account. Contact support if you’d like access.
What is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI tools to connect to external data sources. When you create an MCP access token in Sequence, compatible AI assistants can:
- View your activities and workouts
- Read scheduled training sessions and their results
- Access widget data (sliders, selects, measures, logbook entries)
- See your goals and their status
All access is read-only — external tools cannot modify your data.
Creating an Access Token
Open Settings
Navigate to Settings from the sidebar.
Find MCP Connector
Scroll to the MCP Connector section.
Create new token
Click New Token and enter:
- Name — A descriptive name (e.g., “Claude Desktop”)
- Scopes — Select which data the token can access:
sequence.training:read— Activities, sessions, and widgetssequence.goals:read— Goals and their details
Confirm with password
Enter your account password to confirm token creation.
Copy the token
Copy the token immediately — it’s only shown once. Store it securely.
Tokens are displayed only once when created. If you lose a token, revoke it and create a new one.
Configuring Your AI Tool
After creating a token, configure your MCP-compatible AI tool:
- Server URL — Use the MCP endpoint URL shown in Settings
- Authentication — Use Bearer token authentication with your
seq_mcp_token
Refer to your AI tool’s documentation for specific setup instructions.
Available Data
The MCP Connector provides read-only access to:
| Data Type | Scope Required | Description |
|---|---|---|
| Activities | sequence.training:read | Your workouts and their details |
| Training Sessions | sequence.training:read | Scheduled sessions with dates, states, and results |
| Exercises | sequence.training:read | Exercise data including sets, reps, and weights |
| Widgets | sequence.training:read | Slider, select, measure, and logbook entries |
| Goals | sequence.goals:read | Goals with status, dates, and details |
Managing Tokens
View Active Tokens
In Settings → MCP Connector, view all your tokens with:
- Token name
- Token prefix (first characters for identification)
- Status (active, expired, or revoked)
- Last used date
- Expiry date
Revoke a Token
To revoke a token:
- Go to Settings → MCP Connector
- Find the token to revoke
- Click Revoke
Revoked tokens stop working immediately.
Token Limits
You can have up to 5 active tokens at a time. Revoke unused tokens if you need to create new ones.
Security
Token Safety
- Tokens are stored as secure hashes — we never see your raw token after creation
- All connections require HTTPS in production
- Tokens expire after 90 days
- Tokens are automatically revoked if you reset your password
Best Practices
Use descriptive names Name tokens after the tool or purpose (e.g., “Claude Desktop”, “Analysis Script”).
Limit scopes Only grant the scopes each tool actually needs.
Revoke unused tokens Remove tokens you’re no longer using.
Rotate periodically Create new tokens and revoke old ones if you suspect exposure.
Treat MCP tokens like passwords. Never share them publicly or commit them to code repositories.
Troubleshooting
Token not working
- Check the token hasn’t expired (90-day limit)
- Verify the token wasn’t revoked
- Ensure you’re using the correct endpoint URL
- Confirm you’re using Bearer authentication
Missing data
- Verify the token has the required scope for the data type
- Check that the data exists in your Sequence account
Rate limiting
The MCP endpoint has rate limits to prevent abuse. If you’re seeing rate limit errors, reduce request frequency.