Everfit API and MCP server

• POST

  list_clients

  Clients in your workspace with type, coach, groups and status.

  read

  Lists your clients with type (online, in person or hybrid), the coach they belong to, groups and status. Archived clients are returned only when you ask for them. Use the client_id of each item in the other tools. Pass next_cursor back as cursor for the next page.

  POST /api/v1/everfit/list_clients

  Input

  Input: list_clients

  Parameter	Type	Description
  status	enum	active or archived. Default: active.
  type	enum	online, in_person or hybrid.
  group	string	Only clients in this group.
  coach_id	string	Only clients of this coach.
  search	string	Name or email contains.
  limit	integer	1 to 200. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "clients": [
      {
        "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
        "first_name": "Sam",
        "last_name": "Rivera",
        "email": "sam@example.com",
        "type": "online",
        "coach_id": "64a1b2c3d4e5f6a7b8c9d0e1",
        "groups": [
          "Fat loss"
        ],
        "status": "active",
        "joined_at": "2026-09-15"
      }
    ],
    "next_cursor": null
  }

• POST

  get_client

  Client overview: profile, goals, limitations or injuries, private notes and workout counts.

  read

  Returns what the client overview page shows: profile, goals, limitations or injuries, your private notes, and the number of workouts tracked in the last 7 and 30 days. Notes and limitations are not shared with the client.

  POST /api/v1/everfit/get_client

  Input

  Input: get_client

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "first_name": "Sam",
    "last_name": "Rivera",
    "type": "online",
    "goals": "Lose 5 kg before the wedding in March.",
    "limitations": "Mild left knee pain on deep squats.",
    "notes": "Prefers morning sessions.",
    "workouts_tracked": {
      "last_7_days": 0,
      "last_30_days": 9
    }
  }

• POST

  list_workouts

  Workouts on a client's training calendar in a date range, with completion and logged results.

  read

  Returns the workouts on one client's training calendar between two dates, each with whether the client completed it and the results they logged. The default range is the last 7 days and the next 7 days. Use it to find clients with no tracked workouts.

  POST /api/v1/everfit/list_workouts

  Input

  Input: list_workouts

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  from	date	Start date. Default: 7 days ago.
  to	date	End date. Default: 7 days ahead.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "workouts": [
      {
        "workout_id": "w_4a91",
        "date": "2026-10-06",
        "title": "Lower Body A",
        "completed": false,
        "results": null
      },
      {
        "workout_id": "w_4a92",
        "date": "2026-10-08",
        "title": "Upper Body A",
        "completed": false,
        "results": null
      }
    ],
    "completed_count": 0,
    "planned_count": 2
  }

• POST

  get_body_metrics

  Entries for a client's tracked metrics, such as weight, with date, time and unit.

  read

  Returns the entries a client has for a metric, such as Weight or a custom metric, each with date, time, value and unit, plus the change from the first to the last entry in the range. Only metrics enabled for that client return data. Without metric, it returns every tracked metric.

  POST /api/v1/everfit/get_body_metrics

  Input

  Input: get_body_metrics

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  metric	string	Metric name, e.g. Weight. Default: all tracked metrics.
  from	date	Start date. Default: 90 days ago.
  to	date	End date. Default: today.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "metric": "Weight",
    "unit": "kg",
    "entries": [
      {
        "recorded_at": "2026-07-12T08:10:00Z",
        "value": 84.2
      },
      {
        "recorded_at": "2026-08-16T08:05:00Z",
        "value": 82.9
      },
      {
        "recorded_at": "2026-09-20T08:20:00Z",
        "value": 81.5
      },
      {
        "recorded_at": "2026-10-10T08:12:00Z",
        "value": 80.6
      }
    ],
    "change": -3.6
  }

• POST

  list_programs

  Programs in your Program Library with length in weeks.

  read

  Lists the programs in your Program Library with their length in weeks. Pass program_id to assign_program.

  POST /api/v1/everfit/list_programs

  Input

  Input: list_programs

  Parameter	Type	Description
  search	string	Program name contains.

  Example response

  {
    "programs": [
      {
        "program_id": "65d8b7c6a5f4e3d2c1b0a9f8",
        "title": "Beginner Strength",
        "weeks": 8
      },
      {
        "program_id": "65d8b7c6a5f4e3d2c1b0a9f9",
        "title": "Hypertrophy Block",
        "weeks": 12
      }
    ]
  }

• POST

  list_autoflows

  Your Autoflows with name, status and number of clients.

  read

  Lists the Autoflows you can see, your own and those shared with the team, with their status (active or paused) and how many clients are in each. Adding a client to a paused Autoflow sends them nothing until it is activated.

  POST /api/v1/everfit/list_autoflows

  Input

  Input: list_autoflows

  Parameter	Type	Description
  status	enum	active, paused or all. Default: all.

  Example response

  {
    "autoflows": [
      {
        "autoflow_id": "65e0a1b2c3d4e5f6a7b8c9d0",
        "name": "12-week Fat Loss",
        "status": "active",
        "clients": 18
      },
      {
        "autoflow_id": "65e0a1b2c3d4e5f6a7b8c9d1",
        "name": "New client onboarding",
        "status": "paused",
        "clients": 4
      }
    ]
  }

• POST

  list_conversations

  Your Inbox conversations with clients: who, unread flag and last message.

  read

  Lists your Inbox conversations with clients, with the last message and whether it is unread. Chats with teammates are in the Team tab in Everfit and are not returned. Set unread_only to get what needs an answer.

  POST /api/v1/everfit/list_conversations

  Input

  Input: list_conversations

  Parameter	Type	Description
  unread_only	boolean	Only conversations with unread messages.
  limit	integer	1 to 100. Default: 30.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "conversations": [
      {
        "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
        "name": "Sam Rivera",
        "unread": true,
        "last_message": "Can I swap barbell rows for dumbbell rows this week?",
        "updated_at": "2026-10-10T17:42:00Z"
      }
    ],
    "next_cursor": null
  }

• POST

  get_conversation

  Messages with one client, oldest first, with links to images and videos.

  read

  Returns the messages in your Inbox conversation with one client, oldest first, with who sent each and links to images and videos they attached. Read the thread before drafting a reply.

  POST /api/v1/everfit/get_conversation

  Input

  Input: get_conversation

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  limit	integer	1 to 200. Default: 50.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "messages": [
      {
        "from": "Sam Rivera",
        "text": "Can I swap barbell rows for dumbbell rows this week?",
        "media": [],
        "sent_at": "2026-10-10T17:42:00Z"
      }
    ]
  }

• POST

  invite_client

  Add a client and email them an invite to set up the Everfit app.

  asks first write

  Adds a client with first name, last name, email and type, and Everfit emails them an invite right away to set up their profile. By default you are their coach; owners and admins can assign another coach. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/invite_client

  Input

  Input: invite_client

  Parameter	Type	Description
  first_name required	string	First name.
  last_name required	string	Last name.
  email required	string	Client email; the invite goes here.
  type	enum	online, in_person or hybrid. Default: online.
  coach_id	string	Assign another coach. Owners and admins only. Default: you.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5b7",
    "email": "alex@example.com",
    "type": "online",
    "coach_id": "64a1b2c3d4e5f6a7b8c9d0e1",
    "status": "invited"
  }

• POST

  assign_program

  Add a program to a client's training calendar from a start date.

  asks first write

  Adds a program from your Program Library to one client's training calendar, starting on the date you give. Set start_day and end_day to assign only part of the program. Workouts appear on the calendar right away and you can adjust them per client afterwards. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/assign_program

  Input

  Input: assign_program

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  program_id required	string	Program ID from list_programs.
  start_date required	date	First day of the program on the calendar.
  start_day	integer	Program day to start at. Default: 1.
  end_day	integer	Program day to end at. Default: the last day.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "program": {
      "program_id": "65d8b7c6a5f4e3d2c1b0a9f8",
      "title": "Beginner Strength",
      "weeks": 8
    },
    "start_date": "2026-10-12",
    "end_date": "2026-12-06",
    "workouts_added": 24
  }

• POST

  add_client_to_autoflow

  Enroll a client in an Autoflow; an active one sends its workouts, tasks and announcements.

  asks first write

  Adds a client to an Autoflow. In an active Autoflow the client is activated and receives all scheduled workouts, announcements and tasks; in a paused one they receive nothing until it is activated. start_date and start_day set where the client begins. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/add_client_to_autoflow

  Input

  Input: add_client_to_autoflow

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  autoflow_id required	string	Autoflow ID from list_autoflows.
  start_date	date	Date the client starts. Default: today.
  start_day	integer	Autoflow day to begin on. Default: 1.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "autoflow": {
      "autoflow_id": "65e0a1b2c3d4e5f6a7b8c9d0",
      "name": "12-week Fat Loss",
      "status": "active"
    },
    "client_status": "active",
    "start_date": "2026-10-12",
    "start_day": 1
  }

• POST

  log_body_metric

  Add a result for one of a client's tracked metrics.

  asks first write

  Saves a result for one metric enabled for the client, with a value and the date and time of the entry. The client sees it in their metrics and charts. The metric must already be enabled for the client in Everfit. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/log_body_metric

  Input

  Input: log_body_metric

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  metric required	string	Metric name, e.g. Weight.
  value required	number	Value in the metric's unit.
  recorded_at	datetime	ISO 8601. Default: now.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "metric": "Weight",
    "value": 80.6,
    "unit": "kg",
    "recorded_at": "2026-10-10T08:12:00Z",
    "status": "saved"
  }

• POST

  assign_task

  Add a task to a client's calendar, with instructions and a reminder time.

  asks first write

  Adds one task to a client's calendar on a date. The client gets a push notification on that day, at 10:00 in their local time unless you set reminder_time, and checks the task off in the client app. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/assign_task

  Input

  Input: assign_task

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  title required	string	Task title.
  date required	date	Day the task appears.
  instructions	string	Task details for the client.
  link	string	URL to attach, e.g. a form or video.
  reminder_time	string	Reminder time HH:MM in the client's local time. Default: 10:00.

  Example response

  {
    "task_id": "t_7c20",
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "title": "Weekly measurements",
    "date": "2026-10-12",
    "reminder_time": "08:00",
    "status": "assigned"
  }

• POST

  send_message

  Send a message to a client in Inbox, as you.

  asks first write

  Sends a text message to one client in your Inbox conversation, under your name. Everfit lets you edit a plain text message only within 60 minutes. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/send_message

  Input

  Input: send_message

  Parameter	Type	Description
  client_id required	string	Client ID from list_clients.
  text required	string	Message text.

  Example response

  {
    "client_id": "66f1c2a9e4b0a1d2c3f4e5a6",
    "message_id": "msg_91d3",
    "status": "sent",
    "sent_at": "2026-10-11T09:05:00+02:00"
  }

• POST

  send_broadcast

  Inbox Broadcast to many clients at once. Studio plan.

  asks first write

  Sends an Inbox Broadcast of up to 3 messages to the clients you pick, or to all clients. {first_name} is filled in per client. Needs the Studio plan, and Everfit asks you to wait 2 minutes before the next broadcast. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/everfit/send_broadcast

  Input

  Input: send_broadcast

  Parameter	Type	Description
  client_ids	string[]	Recipients. Omit when all_clients is true.
  all_clients	boolean	Send to every client.
  messages required	string[]	Up to 3 messages; {first_name} is filled in per client.

  Example response

  {
    "broadcast_id": "bc_2f08",
    "recipients": 42,
    "messages_per_client": 1,
    "status": "sent",
    "sent_at": "2026-10-11T09:10:00+02:00"
  }

Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.