# Tally Workout

> Tally Workout is a free MCP server for health and science. Remote MCP server that lets AI agents plan workouts in the Tally iPhone app. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** iOS, API
- **Website:** https://tallyworkout.app
- **Repository:** https://github.com/westvegh/tally-workout-mcp
- **MCP Registry name:** io.github.westvegh/tally-workout
- **Categories:** health and science
- **Listing updated:** 2026-11-15

## About

Tally is a free iPhone strength logger, and this server is the bridge that lets an AI agent read your lifting history and write next week's plan into the app. You log each set at the gym; the agent then plans from what you actually lifted rather than what was planned.

The server is hosted at mcp.tallyworkout.app over Streamable HTTP. Clients can connect with OAuth 2.1 (PKCE and dynamic client registration) or with an API key made in the app, which can be read-only, read and plan, or full access. Only full-access keys and OAuth connections can change finished workouts, and each change can be undone for 7 days.

The README documents 21 tools, 10 for reading and 11 for writing. The server itself is closed source and runs inside the Tally backend; only the docs repository is public.

## Features

- **Training history access:** Agents read logged workouts set by set, with weekly totals and per-exercise progress.
- **Workout planning:** Agents write planned workout days into the Tally app for you to follow at the gym.
- **Scoped API keys:** Keys are read-only, read and plan, or full access, and each app gets its own revocable key.
- **OAuth 2.1 sign-in:** Clients that support OAuth connect with PKCE and dynamic client registration.
- **Seven-day undo:** Changes to finished workouts can be reverted for 7 days.

## Good for

- Ask an agent to plan four lifting days around a sore shoulder
- Review how last week's sets compared with the plan
- Track estimated 1RM progress on chosen lifts
- Switch between AI clients while keeping one training log

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http tally-workout https://mcp.tallyworkout.app/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.tallyworkout.app/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tally-workout": {
      "url": "https://mcp.tallyworkout.app/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "tally-workout": {
      "type": "http",
      "url": "https://mcp.tallyworkout.app/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "tally-workout": {
      "serverUrl": "https://mcp.tallyworkout.app/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tally-workout": {
      "type": "http",
      "url": "https://mcp.tallyworkout.app/api/mcp"
    }
  }
}
```

## Tools

- `get_training_context`: Returns planned days from today, the weight unit and optionally recent workouts.
- `get_workout_history`: Returns logged workouts, newest first, set by set.
- `get_workout`: Returns one logged workout by its id, set by set.
- `get_exercise_progress`: Returns progress for up to 10 exercises over 365 days, with top sets and estimated 1RM.
- `get_planned_workout`: Returns one planned day in full, with its version.
- `search_exercises`: Matches exercise names to the user's recent exercises and the Tally library.
- `get_exercise`: Returns one exercise by id: muscles, equipment and instructions.
- `get_training_summary`: Returns weekly totals for up to 12 weeks including volume by muscle and missed plans.
- `get_saved_workouts`: Returns the user's saved and favorite workout templates.
- `get_workout_versions`: Lists the restorable versions of one finished workout.
- `plan_workout_day`: Write tool for planning a workout day.

## FAQ

### Which AI clients work with it?

The README lists Claude, Claude Code, Codex, ChatGPT, Muse, Hark, Perplexity and Dots, plus any MCP client with OAuth 2.1 or a bearer token field.

### Do I need the iPhone app?

Yes. You need the Tally app and a Tally account; the app is free.

### Can the agent edit workouts I already finished?

Only with a full-access key or an OAuth connection, and changes can be undone for 7 days.

### Is the server open source?

No. The README says the server is first-party and closed source; the repository holds docs only.

### Is Tally Workout free?

Yes. Tally Workout is free to use.

### How do I add Tally Workout to Claude Code?

Run this command in your terminal: claude mcp add --transport http tally-workout https://mcp.tallyworkout.app/api/mcp

### What are the best alternatives to Tally Workout?

The closest alternatives to Tally Workout are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/tally-workout
