Motra now integrates with AI assistants like Claude and ChatGPT, giving you a powerful new way to explore and understand your workout data. Ask questions about your training history, analyze your progress, and get recovery and nutrition guidance, all through a natural conversation with AI.
What is MCP?
MCP is an open protocol that lets AI assistants securely connect to external apps and data sources. When you connect Motra, your AI assistant can read your training data and answer questions about your fitness journey — without you having to copy-paste anything.
What you can do
Once connected, you can ask your AI assistant to:
Query your workout history
View past workouts with details like date, duration, calories burned, muscle groups trained, and exercise/set counts. Filter by date range, sort by duration or calories, and review your training consistency.
Track exercise progression
Get set-by-set performance history for any exercise — including weight, reps, total volume load (weight x reps), and RPE (rate of perceived exertion). See exactly how your bench press, squat, or any other lift has progressed over time.
Analyze training stats
Run aggregations across your training data: totals, averages, maximums, counts, and ranked lists. Find your top exercises by volume, see how many workouts you did this month, calculate your average session duration, or identify your most-trained muscle groups.
View achievements and PRs
Review personal records and milestones earned during your workouts — new max weights, volume milestones, consistency streaks, and more.
Explore the exercise library
Search Motra's exercise database by muscle group, equipment type, training goal, or keyword. Get detailed information about any exercise including primary and secondary muscles, equipment needed, difficulty rating, and description.
Browse your workout templates
View your saved workout templates (AI-generated training plans from Motra) with full details: estimated duration, target muscle groups, equipment needed, and the complete exercise breakdown with sets, reps, and weights.
Available tools
Tool | What it does |
Query Workouts | Search your workout history by date range, sort by time/duration/calories |
Exercise History | Get set-by-set data for a specific exercise with weight, reps, volume, RPE |
Stats Aggregation | Calculate totals, averages, maximums, counts, and top-N rankings |
Achievements | View personal records and training milestones |
Search Exercises | Find exercises by muscle group, equipment, goal, or keyword |
Get Exercise Details | Full exercise info — muscles, equipment, difficulty, description |
List Templates | Your saved workout templates with complete exercise breakdowns |
All tools are read-only — Motra's MCP integration never modifies your data.
Coming Soon
Create workout plans. Have the AI build new templates and push them directly into Motra.
Edit existing workouts. Let the AI update old workouts or templates on your behalf.
And more. We're actively building new capabilities for this integration. Stay tuned!
Requirements
Before connecting, make sure you have:
A Motra account with workout data — Sign up and log workouts in the Motra iOS app first. MCP connects to your existing account and cannot create new accounts.
A supported AI assistant — See the setup guides below.
Setup guides
Claude (Desktop and Web)
Claude supports Motra as a built-in connector on both claude.ai and the Claude Desktop app.
Steps:
Open Claude at claude.ai or launch the Claude Desktop app
Click your profile icon and go to Settings
Navigate to Connectors (or Integrations)
Search for Motra
Click Connect and sign in with your Motra account (Google, Apple, or email)
Once connected, you'll see Motra listed as an active connector
Using Motra in conversations:
Start a new conversation — Motra tools are automatically available
You can toggle Motra on or off for specific conversations from the connector menu at the top of the chat
Simply ask questions about your training and Claude will use the appropriate Motra tools
Example conversation:
You: How has my bench press progressed this year?
Claude: I'll check your bench press history. (uses Exercise History tool)
Here's your bench press progression for 2026:
Jan 15: 80kg x 8 reps (RPE 8)
Feb 2: 82.5kg x 7 reps (RPE 8.5)
Feb 18: 85kg x 6 reps (RPE 9) ...
Claude Code (CLI)
If you use Claude Code in the terminal, you can connect Motra directly from the command line.
Steps:
Open your terminal and run:
claude mcp add motra --transport http https://mcp.motra.com/mcp
Open a new terminal tab and start Claude:
claude
Inside Claude Code, run:
/mcp
Select motra from the list and choose Authenticate
A browser window will open — sign in with your Motra account
Return to the terminal. Motra tools are now available in your Claude Code session.
ChatGPT
ChatGPT supports Motra through its Connected Apps feature.
Note: Requires a ChatGPT Plus, Pro, Business, or Enterprise plan.
Steps:
Open ChatGPT at chatgpt.com
Click your profile icon and go to Settings
Navigate to Connected Apps
Search for Motra and click Connect
Sign in with your Motra account (Google, Apple, or email)
Once connected, you can reference Motra in your conversations
Using Motra in ChatGPT:
Mention @Motra in your message to explicitly invoke Motra tools
Or simply ask about your workouts — ChatGPT will automatically use Motra when relevant
You can manage the connection from Settings → Connected Apps at any time
Other MCP clients
Any MCP client that supports Streamable HTTP transport and OAuth 2.0 authentication can connect to Motra.
Server URL:
https://mcp.motra.com/mcp
Configuration example (JSON):
{ "motra": { "url": "https://mcp.motra.com/mcp" } }For stdio-only clients, use mcp-remote as a bridge:
{ "motra": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.motra.com/mcp"] } }Your client will be guided through browser-based OAuth sign-in automatically when you first connect.
Example prompts
Here are some things you can ask once Motra is connected:
Workout history
"Show my last 5 workouts"
"What workouts did I do this week?"
"Show my longest workouts this month"
Exercise progression
"How has my bench press progressed over the last 3 months?"
"Show my squat history — weight and reps for each session"
"What's my deadlift volume trend?"
Training stats
"What's my total volume this month?"
"How many workouts did I do in January?"
"What are my top 5 exercises by total volume?"
"Which muscle groups am I training the most?"
"What's my average workout duration this year?"
Personal records
"Show my recent PRs"
"Any new achievements this month?"
Exercise library
"Find exercises that target the chest with dumbbells"
"What muscles does the Romanian deadlift work?"
"Show me beginner-friendly back exercises"
Templates
"List my saved workout templates"
"What does my Push Day template look like?"
"Which template is best for a pull workout?"
Troubleshooting
"No Motra account found"
You need to create a Motra account in the iOS app before connecting via MCP. Sign up, log at least one workout, and then try connecting again. Make sure you sign in with the same account (Google, Apple, or email) that you use in the app.
"No tools available" or tools not appearing
Try disconnecting and reconnecting the Motra connector in your AI assistant's settings
Make sure you completed the authentication step — check that Motra appears as "Connected" in your settings
If using Claude Code, try removing and re-adding the connection:
claude mcp remove motra claude mcp add motra --transport http https://mcp.motra.com/mcp
Tools return empty results
Verify you're signed in with the same account you use in the Motra app
Make sure you have logged workouts in the app — MCP reads your existing data
Check that the date range in your question matches when you actually worked out
"Authorization failed" or sign-in issues
Try signing in with a different method (Google, Apple, or email) that matches your Motra app account
Clear your browser cookies and try again
If using a corporate network, check that
mcp.motra.comis not blocked by your firewall
Connection drops or token expires
Access tokens refresh automatically. If you experience connection issues after extended periods:
Go to your AI assistant's settings and re-authenticate the Motra connector
For Claude Code, run
/mcpand re-authenticate
Workouts from a specific period are missing
Motra MCP returns data based on your account's workout history. If workouts are missing, verify they were synced in the Motra app. Check the app's workout history to confirm the data is available.
Privacy and security
We take your data security seriously. Here's how Motra's MCP integration protects your information:
OAuth 2.1 with PKCE — Industry-standard secure authentication with proof key for code exchange, preventing token interception attacks
HTTPS everywhere — All data transmitted between your AI assistant and Motra is encrypted in transit
Read-only access — MCP tools can only read your data. No workouts, settings, or account information can be modified through MCP
Per-session access — Your data is only accessed when you actively use Motra tools in a conversation. There is no background data collection
Token-based sessions — Access tokens expire automatically. You can revoke access at any time by disconnecting the Motra connector from your AI assistant's settings
No data storage by AI assistants — Your workout data is fetched on-demand and is subject to your AI assistant's own data handling policies
For more details, review our Privacy Policy and Terms of Service.
Frequently asked questions
Can MCP modify my workouts or account settings? No. All Motra MCP tools are strictly read-only. Your data cannot be changed through the integration.
Do I need a paid Motra plan? No. Motra MCP works with any Motra account that has workout data. You do need a compatible AI assistant plan (e.g., ChatGPT Plus for ChatGPT, or any Claude plan that supports connectors).
Which AI assistants are supported? Currently Claude (web, desktop, and CLI) and ChatGPT. Any MCP-compatible client that supports Streamable HTTP and OAuth 2.0 can also connect.
Can I use Motra MCP on mobile? Yes, if your AI assistant's mobile app supports connectors/integrations. Claude's mobile app and ChatGPT's mobile app both support connected apps.
How often is my data updated? MCP fetches your data in real-time from Motra's servers. As soon as a workout is synced in the Motra app, it's available through MCP.
Can I connect multiple Motra accounts? Each AI assistant connection is linked to one Motra account. To switch accounts, disconnect and reconnect with different credentials.
Is my data shared with the AI company? Your workout data is sent to the AI assistant only when you ask questions that require it. It's subject to the AI provider's data handling policies (Anthropic for Claude, OpenAI for ChatGPT). Motra does not share your data with any third party beyond what's needed to answer your query.
Need help? Contact us at help@motra.com