Connectors
What It Is
A connector lets you use Atlas from a chat app such as Claude, ChatGPT, Gemini or Grok. You add Atlas once, approve it on the console, and then ask in plain language: who missed sessions this week, what Sam logged, or move Thursday's squats to Friday. The chat works as you, in the club and with the access you approved, and asks before it changes anything.
Agents that run commands, such as Claude Code or Codex, can use the Agent Skill and the Atlas CLI instead.
Connect An App
- Copy the connector address,
https://atlas.meetcal.app/mcp. It is also in Settings, under Integrations, in the console and in Atlas Desktop. - Add it as a custom connector in the app:
- Claude: Customize, then Connectors, then + Add, then Add Custom Connector. On a Team or Enterprise plan, an owner adds it first.
- ChatGPT: On the web, Plugins, then +, then Add Custom MCP Server. Changing Atlas needs a Business, Enterprise or Edu plan; Pro can only read.
- Gemini: On the web, Settings, then Connected Apps, then Add A Custom App. Needs a personal Google account in the US, age 18 or over, with Keep Activity on.
- Grok: On grok.com, Connectors, then New Connector, then Custom.
- The app opens an Atlas page, such as Connect Claude. Check the app's name and the site it returns to, and tick the box that says you just started connecting it. Then choose the club (when you coach more than one), Access and Expires, and choose Approve or Deny.
Expires offers 30, 90, or 180 days, or No Expiry, and it starts at 90 days. Access starts with Read Athletes And Programs, plus Create And Edit when the app asks for it. Nothing else is ever pre-selected, so turn on anything more the task needs before you approve.
The connection appears in your tokens on Integrations, named for the app. Revoke it there to disconnect; when it expires, the app asks you to approve it again.
Tools
Each tool does one thing in Atlas and is marked as reading or changing it, so the chat app can ask you before every change.
Account
get_account: Shows the club this connection works in, the coach it acts as, the access the coach approved, and the current rate limit.get_dashboard: Lists each athlete on the roster who has a program, with that program's summary on a date: the one running that day, else the next to start, else the most recent.get_roster_overview: Lists each athlete on the roster as the Dashboard's table shows them: program status and week, sessions done this week and today, when the next program is due, the next meet, and alerts.get_notification_counts: Counts the unread comments, videos, questionnaires, check-ins, document notifications and meet plan reminders waiting in Notifications.get_coach_settings: Gets the coach's settings in this club, including the defaults their athletes follow until a coach changes an athlete's own setting, such as whether athletes may add exercises.update_coach_settings: Changes the coach's settings in this club, such as the week start day or the defaults for their athletes, like defaultAthletesCanAddExercises. Only the fields sent change.get_profile: Gets the coach's name as this club shows it, the unit their loads show in, and whether they have a profile photo.update_profile: Changes the coach's name, which renames them in every club they coach, or the kg or lb unit their loads show in. A club whose training history is too large keeps the old name, and the result says which.remove_profile_photo: Deletes the coach's profile photo, so athletes and other coaches see their initials instead. A new photo is uploaded in the console or the app.list_api_tokens: Lists the access tokens the coach made for this club, including this connection's, with each one's access, last use and expiry, but not the token itself. Revoking one stays in the console's Settings → Integrations or the CLI.get_club_settings: Gets the club's settings: the sport new athletes start with, whether athletes edit their own PRs, and how many weeks ahead athletes see their program, each unless an athlete's own setting says otherwise.list_lift_ratio_ranges: Lists the ideal ranges the coach set for lift ratios, such as snatch to clean and jerk. A ratio not listed uses Atlas's default range.set_lift_ratio_range: Sets the coach's ideal range for one lift ratio, as a minimum and maximum percentage of its base lift. Athletes' lift ratios are compared against it.reset_lift_ratio_range: Removes the coach's range for one lift ratio, so it goes back to Atlas's default range.
Athletes
list_athletes: Lists the athletes on the coach's roster with their athleteId, one page at a time. Pass the returned cursor to read the next page until isDone is true.get_athlete: Gets one athlete's profile: name, sport, profile fields such as goals, and which apps they connected. Injury history and coach notes come back only when the coach approved the write access.update_athlete: Changes an athlete's name or profile fields, such as goals, injury history, weight class or coach notes. Only the fields sent change, and each replaces what was there.get_athlete_settings: Gets an athlete's training settings: whether readiness adjusts their percentages, whether estimates can set their PRs, whether they edit their own PRs, whether they may add exercises or workouts in the app, how many weeks ahead they see their program in the app, and their sport.update_athlete_settings: Changes an athlete's training settings: whether readiness adjusts their percentages, whether estimates can set their PRs, whether they edit their own PRs in the app, whether they may add exercises or workouts, how many weeks past the current one they see their program in the app, or their sport while it is not yet in use. Only the fields sent change. Turn canAddExercises off so the athlete can't add exercises to a session or a workout to a rest day; coachDefault follows their coach's default. Turning off PR editing or adding exercises leaves the coach's own edits open.get_session_activity: Lists recent sessions with logged work or a completion, for the whole roster or one athlete, optionally with planned sessions not yet done.list_check_ins: Lists an athlete's pre- and post-workout check-ins, optionally between two dates, each with the questions the athlete answered and their answers. Sleep, energy, soreness, stress, movement quality, focus and body feel are also given as 1 to 5 scores when the club's check-in asks them; missed lifts run 0 to 5 or more.get_training_log: Gets an athlete's programmed workouts as flat rows with what they logged and a summary of each logged lift (top set, estimated 1RM, volume, reps, made and missed sets), for every program or one program by name.get_missed_lifts_by_exercise: Gets an athlete's missed lifts by exercise, optionally between two dates: each exercise's total missed sets, most missed first, with weekly sums, plus the athlete's weekly total. One miss is one set marked Miss.get_analytics: Gets weekly training analytics over a range ending on a date, for the coach's whole roster or one athlete.get_analytics_board: Gets the charts on an athlete's analytics board: built-in charts, and custom charts with their metrics, chart type, time range and lift filter.save_analytics_board: Replaces an athlete's analytics board with the given charts, in order. To add, edit or remove one chart, read the board with get_analytics_board, change that item, and send every item back. Only the coach who saves it sees this board.get_pace_trends: Gets an athlete's weekly average pace per mile for each exercise they logged with a distance and a time, over a range ending on a date.list_check_in_alerts: Lists athletes on the roster who missed planned training or sent no videos of their recent sessions, unread first.mark_check_in_alert_read: Marks one athlete's check-in alert read until they miss more.mark_check_in_alert_unread: Removes the read mark from one athlete's check-in alert.mark_all_check_in_alerts_read: Marks unread check-in alerts read in batches, optionally for one athlete; remaining says how many are left.list_meet_plan_reminders: Lists upcoming meets of coached athletes that have no meet plan yet, soonest first.list_document_notifications: Lists athletes who finished their club forms or whose Training an unsigned form locked, unread first.mark_document_notification_read: Marks one document notification read.mark_document_notification_unread: Removes the read mark from one document notification.mark_all_document_notifications_read: Marks unread document notifications read in batches, optionally for one athlete; remaining says how many are left.get_form_reminder_status: Shows whether an athlete can be reminded now to sign their club forms: why not, when they were last reminded, and when Remind works again.get_remind_all_status: Shows when Remind All for the club's forms works again and how the last run went. For Club Admins.list_personal_records: Lists an athlete's personal records for the lifts their sport tracks, plus any custom-named records.save_personal_record: Sets an athlete's personal record for a lift at a rep max, replacing the current record for that lift and rep max. The athlete sees it in the Atlas app.list_opened_rep_maxes: Lists the rep maxes a coach opened for an athlete above a lift's tracked top, such as a snatch 5RM. An opened rep max counts like a tracked one.set_opened_rep_max: Opens a rep max above a lift's tracked top for one athlete, up to 10RM, or closes it again. Once open, the athlete's PRs store it and a made set at exactly that many reps raises it. Closing keeps the stored PR and its history.get_recent_bests: Gets an athlete's best estimated one-rep maxes from completed, non-missed sets in the last three months.calculate_training_weights: Calculates training weights at the given percentages of an athlete's personal record for a lift, to the nearest rounding increment. Changes nothing.list_meets: Lists an athlete's meets. Athletes in general fitness have none.get_qualifying_totals: Gets the totals a weightlifter needs to qualify for each national event and age category, from their birth date, weight class and gender, or why none show. Weightlifting athletes only.refresh_qualifying_totals: Asks MeetCal for the latest qualifying standards when they are due. They arrive in the background; read them again with get_qualifying_totals.refresh_open_powerlifting: Asks Open Powerlifting for a linked powerlifter's latest meets when they are due. They arrive in the background.get_recent_competition_lifts: Summarizes an athlete's competition lifts in training over the last two months: sessions with each lift, the heaviest weight, and heavy reps made and missed.list_competition_reports: Lists the scores an athlete gave in each post-meet questionnaire they submitted, newest meet first.get_output_dashboard: Reads an athlete's Output Sports testing, live: each exercise tested, every session's metrics and their jump height trend, when the athlete is linked to Output Sports.get_output_jump_height: Reads the jump heights an athlete linked to Output Sports recorded, oldest first.list_club_athletes: Lists every athlete and group program in the club with their assigned coach, including those another coach coaches, and whether the coach may open each one.get_club_retention: Club Admins only. Gets the club's retention report: each individually coached athlete's coaching dates and package, monthly joins, departures and churn, and the same totals per coach.get_club_highlights: Gets the club's highlights for a month, a year or all time: totals such as sessions, volume and PRs, and leaderboards, optionally for one coach's athletes.get_club_highlight_card: Renders the club's highlights for a period as a shareable SVG image for a feed post or a story, optionally with its leaderboards.get_club_wrapped: Gets the club's year in review as slides with SVG images while Wrapped is open in December; empty outside it.list_run_leaderboards: Lists the club's fastest run times at each distance across its general fitness athletes, optionally for one coach's athletes.get_run_leaderboard: Ranks the club's general fitness athletes by their run PR at one distance, fastest first.get_exercise_leaderboard: Ranks the club's athletes on a record lift or club lift by their best completed set as a percentage of their 1RM.save_week_note: Sets the coach's note for the week containing a date, replacing any note already there. Every day from that week's Sunday through Saturday shares one note.get_oura_data: Reads an athlete's sleep and readiness from Oura, live, for a date range, when the athlete connected Oura in the Atlas app. Atlas does not store it.get_nutrition: Reads an athlete's daily calorie and macronutrient totals from FatSecret, live, for a date range, when the athlete connected FatSecret in the Atlas app. Atlas does not store them.get_athlete_check_in_settings: Gets an athlete's own pre- and post-workout check-ins, where null follows their coach and then the club, and the ones they inherit.set_athlete_check_in_setting: Picks one athlete's own pre- or post-workout check-in, or null to follow their coach and club. Their assigned coach or a Club Admin may.
Programs
get_current_program: Gets the program an athlete is on for a date, in full: weeks, days and exercises with sets, reps and loads, and its revision.list_programs: Lists programs for one athlete or for all the coach's athletes, one page at a time.get_program: Gets one program in full, with its revision. Every change to a program needs its current revision.create_program: Creates a new program for an athlete from weeks, days and exercises. Atlas numbers the weeks, days and exercises and fills in defaults, and what the athlete logs is left for them to fill in. The athlete sees it in the Atlas app.update_program_details: Changes a program's name, start date, athlete, rep targets or weekly totals without touching its workouts. Moving the start date can move every scheduled day with it.copy_program_week: Copies a week of a program to a new week number, leaving out what the athlete logged in the original. A week number the program already has is refused. The athlete sees the copied week in the Atlas app.add_program_day: Adds a workout day, with its exercises, to a week of a program. What the athlete logs is left for them to fill in. The athlete sees it in the Atlas app.update_program_day: Changes a workout day's label, weekday, scheduled date, position or coach notes without touching its exercises. A day the athlete already logged work on cannot be changed. The athlete sees the change in the Atlas app.move_program_day: Moves a workout day to another date. When another day of the program is on that date, the two days swap. A day the athlete already logged work on cannot be changed. The athlete sees the change in the Atlas app.add_program_exercise: Adds an exercise, with its sets, reps and loads, to a workout day. A day the athlete already logged work on cannot be changed. The athlete sees it in the Atlas app.update_program_exercise: Changes an exercise's name, sets, reps, loads, notes, superset or position in its day. Only the fields sent change. With a new name, applyToLaterWeeks also switches that movement in later weeks whose same slot still holds it. A day the athlete already logged work on cannot be changed. The athlete sees the change in the Atlas app.delete_program_exercise: Deletes one exercise from a workout day. A day the athlete already logged work on cannot be changed. A deleted exercise cannot be restored.delete_program_day: Deletes one workout day and its exercises from a program week. A day the athlete already logged work on cannot be changed. A deleted day cannot be restored.delete_program_week: Deletes one week from a program, with its days and exercises. A week holding a day the athlete already logged work on cannot be deleted. A deleted week cannot be restored.
Templates, Groups And Exercises
list_templates: Lists the reusable program templates in the coach's library, one page at a time, optionally only those of one sport.get_template: Gets one template in full: its weeks, days and exercises.rename_template: Renames a template, keeping its weeks and folder; programs already assigned from it keep their names. A name another template uses is refused. An assistant renames only templates they made.assign_template: Creates a dated program for an athlete from a template. A template of a different sport from the athlete's is refused. The athlete sees the program in the Atlas app.list_group_programs: Lists the group programs the coach runs, with member counts. A group program is one program many athletes follow.list_group_members: Lists a group program's active members by name, up to 500.list_group_blocks: Lists the training blocks a group program has followed, newest first, with their dates.list_group_member_stats: Shows how each member of a group program is following one block: sessions due and completed, those due this week, their last completed session and their session ratings, one page at a time.list_group_activity: Lists the session comments and PRs a group program's members posted recently, newest first, optionally only one kind.list_group_competition_reports: Lists the post-meet questionnaire scores of a group program's members, one page of members at a time.list_exercises: Browses or searches the Atlas exercise library and the club's own exercises.add_library_exercise: Adds an exercise to the club's exercise library, or to the Atlas library when library is atlas and the coach is the Atlas administrator, who writes the Atlas library unless library is club. An Atlas exercise needs a YouTube video link; a club exercise may leave it out.update_library_exercise: Changes an exercise in the club's exercise library, or in the Atlas library for the Atlas administrator, with library choosing between them as for add_library_exercise. Only the fields sent change. An assistant changes only exercises they added.rename_library_exercise: Renames one of the club's own exercises, keeping its details. Atlas then renames it in the club's templates, programs, PRs and analytics boards in the background, and the result shows renaming until that finishes. Atlas exercises cannot be renamed. An assistant renames only exercises they added.delete_library_exercise: Deletes an exercise from the club's exercise library, or from the Atlas library for the Atlas administrator, with library choosing between them as for add_library_exercise. Only a club admin deletes club exercises.list_questionnaires: Lists the Atlas questionnaires and the club's, each with its use: postMeet, preWorkout or postWorkout check-in.get_questionnaire: Gets a questionnaire and its questions, with each question's answer type, whether it is optional, and the Atlas chart a check-in question feeds.create_questionnaire: Creates a club questionnaire or pre- or post-workout check-in. To edit an Atlas check-in, create a club copy of its questions; with putInUse a Club Admin's copy becomes the club's check-in.update_questionnaire: Renames a club questionnaire or replaces its questions or a pre-workout check-in's readiness levels. Only its creator or a Club Admin may. A charted check-in question keeps its answer type. Answers already given keep their questions, and rated sessions keep their percent.get_check_in_settings: Gets the pre- and post-workout check-ins the club's athletes answer around each session.set_check_in_setting: Club Admins only. Picks the club's pre- or post-workout check-in from the Atlas one or a club check-in of the same use.get_coach_check_in_settings: Gets the check-ins a coach chose for their assigned athletes, where null follows the club, and the club's. A Club Admin may read another coach's.set_coach_check_in_setting: Picks the pre- or post-workout check-in for a coach's assigned athletes, or null to follow the club. A Club Admin may set it for any coach. An athlete's own choice still wins.list_club_lifts: Lists the lifts the club tracks PRs for beyond its sports' record lifts, with each one's sport, top rep max and ratio. A percentage can read one through a basis of { clubLiftId, repMax }.create_club_lift: Club Admins only. Makes an exercise from the club's exercises or the Atlas library a club lift for one sport, storing PRs from 1RM up to its top rep max. Athletes of that sport see it in their PRs.update_club_lift: Club Admins only. Changes a club lift's top rep max or its ideal ratio to a record lift.archive_club_lift: Club Admins only. Takes a club lift out of pickers and PR lists; its PRs, their history and percentages already reading it stay.restore_club_lift: Club Admins only. Brings an archived club lift back, within the limit of active club lifts per sport.list_removed_record_lifts: Lists the built-in record lifts the club removed, per sport. Every other record lift of a sport stays on its athletes' PR tables.remove_record_lift: Club Admins only. Removes a built-in record lift for one sport: it leaves that sport's PR tables, leaderboards, highlights, ratio cards and Percent Of choices, and logged sets stop raising it. Stored PRs and percentages already reading it stay. Competition lifts cannot be removed.restore_record_lift: Club Admins only. Brings a removed record lift back to its sport with the PRs athletes already stored.
Messages And Video Reviews
list_conversations: Lists the coach's message conversations in the club: direct messages and groups.list_messages: Lists the messages in one conversation, one page at a time.send_message: Sends a message from the coach to a conversation, or schedules it for later. Everyone in the conversation sees it and may get a notification.start_direct_message: Finds or creates the direct message conversation between the coach and one person, and returns its conversationId. Sends nothing.list_message_reactions: Lists who reacted to one message and with which emoji, grouped by emoji.search_messages: Searches the text of the messages the coach can read in the club, or in one conversation.search_conversations: Finds conversations in the club by their name or the people in them, including archived ones.get_unread_totals: Counts the coach's unread messages in the club and the conversations flagged Needs Reply.list_message_people: Lists the club members the coach can message, with the userId that start_direct_message takes.get_conversation: Shows one conversation as the inbox does: its name, last message, unread count and the people pictured on it.list_conversation_members: Lists the people in one conversation, with their role and whether they are still in the club.list_conversation_resources: Lists the links, files or reviewed videos shared in one conversation, newest first.list_thread: Shows the thread a message belongs to: its first message and the replies, oldest first.open_athlete_conversation: Finds or creates the conversation between an athlete and their assigned coach, or a minor's family thread with their guardians, and returns its conversationId. Sends nothing.list_coach_conversations: Club owners only. Lists another coach's or assistant's conversations, as the console's coach inbox view does.list_session_videos: Lists an athlete's workout videos for one program day and the coaches' video reviews of them.unsend_workout_videos: Removes the unreviewed videos of a workout upload the coach posted for an athlete. Videos a coach already reviewed stay.unsend_workout_video: Removes one unreviewed video of a workout upload the coach posted for an athlete.list_video_reviews: Lists athletes who sent form-check videos for the coach to review, unread first.get_video_transcript: Reads a voice message's or video's transcript and summary. Either can be empty until the phone that makes it finishes.mark_video_reviewed: Marks an athlete's video reviewed, or takes that mark off, without sending a review. The athlete sees the mark.list_athlete_comments: Lists the comments athletes on the roster left on their training, newest first, optionally unread only.reply_to_comment: Replies to an athlete's comment with a direct message from the coach that quotes it, then marks the comment read. The athlete sees the message.
Search
search: Searches the club's athletes, group programs and templates by name, and returns ids that fetch reads.fetch: Reads one athlete, group program or template that search returned, as a document: an athlete with their current program and recent check-ins, a group with its members and settings, or a template.
Access And Safety
- The chat can do only what the access you approved allows, in the one club you chose. A connector can never delete whole programs or athlete data, manage the club, or get Platform access.
- Atlas marks Claude, ChatGPT, Grok and Muse as known apps. An app on your own computer shows a warning that it runs there, and every other app, including Gemini, shows a warning that Atlas has not verified it. Approve one only if you just started connecting it and it returns to a site you trust.
- Athletes see most changes, such as program edits and messages. Read what the chat proposes before you confirm it.
For Developers
Atlas serves a remote MCP server at https://atlas.meetcal.app/mcp over Streamable HTTP with plain JSON answers, for protocol versions 2025-03-26 through 2026-07-28. Sign-in is OAuth 2.1 with PKCE: protected resource metadata at /.well-known/oauth-protected-resource, authorization server metadata at /.well-known/oauth-authorization-server, client metadata documents or dynamic client registration, and an Atlas personal access token as the access token. Every tool call runs a Coach API operation, so its permissions, rate limits and errors apply.