# Agendolo docs

Source: https://agendolo.com/docs

## What Agendolo is

Weekly routines you can copy, change and share, from the site or your AI app.

A framework is a whole week, hour by hour. Some are built by people like you, others rebuilt from famous routines.

### Seven sections

Every hour of the week belongs to one.

Sleep, Work, Eat, Learn, Move, Play, Home

### Run, remix, publish

Run a framework to show it on your profile. Remix one to make it yours. Publish when it’s ready for others.

## Installation

Agendolo works in any app that supports MCP.

### Before you start

You need a free [Agendolo account](https://agendolo.com/sign-up). Then copy the server URL.

```
https://agendolo.com/mcp
```

### Claude

1. In Claude, open **Settings**, then **Connectors**.
2. Choose **Add custom connector**, paste the server URL and press **Add**.
3. Press **Connect** beside it and sign in to Agendolo.

On a Team or Enterprise plan, an owner adds it in Admin settings first; then everyone connects their own account.

### ChatGPT

1. In ChatGPT, open **Settings**, then **Apps**, and turn on **Developer mode** under Advanced settings.
2. Choose **Create**, name it Agendolo, paste the server URL and pick **OAuth**.
3. Sign in to Agendolo when it asks.

Developer mode isn’t on every ChatGPT plan.

### Cursor

```
{
  "mcpServers": {
    "agendolo": {
      "url": "https://agendolo.com/mcp"
    }
  }
}
```

Add that to `~/.cursor/mcp.json`. Cursor asks you to sign in to Agendolo the first time.

### Claude Code

```
claude mcp add --transport http agendolo https://agendolo.com/mcp --scope user
```

Run that in a terminal, then type `/mcp` in Claude Code and choose agendolo. Your browser opens to sign in.

## Things to ask

Ask in your own words. Your app picks the tools.

### Find a framework

- “Find me a framework for a developer who wants to get fit”
- “What do early risers who run do with their evenings?”

### Make it yours

- “Remix Eliud Kipchoge’s week, but I work 9 to 5”
- “Start a blank framework called My reset week”

### Change your week

- “Move my deep work to the mornings and keep Fridays light”
- “Add a 30 minute walk after lunch on weekdays”

### Publish and run

- “Publish it”
- “Make it the one I’m running”

## How edits work

### Your working copy

Edits save to a private copy only you can see.

### Publishing

Nothing goes live until you ask your app to publish. Each publish is a new version.

### Watching changes in the builder

Keep the builder open and your app’s edits show up within a few seconds.

## If you’re an agent

Everything here is also in [plain text](https://agendolo.com/docs#plain-text).

### The usual flow

1. `search_frameworks` by the person’s role and goals.
2. `get_framework` to read one in full.
3. `create_framework` with `from` to remix it.
4. `update_framework` with every change in one call.
5. `publish_framework` only when the person asks.

### Rules to follow

- Refer to frameworks by their ref.
- Times are 24-hour, on the half hour.
- Goals and roles are the exact values from `get_vocabulary`.
- When a change clashes with another section, ask before replacing it.
- Never publish unless asked.

## Plain text

| URL | What’s there |
| --- | --- |
| [`/llms.txt`](https://agendolo.com/llms.txt) | What Agendolo is, the server URL and links to the rest |
| [`/llms-full.txt`](https://agendolo.com/llms-full.txt) | This whole page as Markdown |

## Tools

Nine tools. Each one needs you signed in.

### Finding frameworks

| Tool | What it does | Inputs |
| --- | --- | --- |
| `search_frameworks` | Finds frameworks by what someone does and wants | `query`, `goals`, `roles`, `sort`, `limit` |
| `get_framework` | Reads one in full, section by section | `ref`, `detail` |
| `get_vocabulary` | Lists the sections, goals and roles | `section` |

### Your frameworks

| Tool | What it does | Inputs |
| --- | --- | --- |
| `my_frameworks` | Your drafts, live frameworks and favourites | None |
| `create_framework` | Starts a blank one or remixes another | `from`, `name` |
| `update_framework` | Makes every edit in one call | `ref`, `name`, `tagline`, `summary`, `goals`, `best_for`, `not_for`, `sections`, `paint`, `others` |
| `publish_framework` | Makes the working copy live | `ref` |
| `run_framework` | Sets the one you’re running | `ref` |
| `favorite_framework` | Adds or removes a favourite | `ref`, `favorite` |

## Vocabulary

### Sections

Sleep, Work, Eat, Learn, Move, Play, Home

### Goals

Body: [Lose weight](https://agendolo.com/goals/lose-weight), [Gain weight](https://agendolo.com/goals/gain-weight), [Build muscle](https://agendolo.com/goals/build-muscle), [Get fit](https://agendolo.com/goals/get-fit), [Train to compete](https://agendolo.com/goals/train-to-compete), [Eat well](https://agendolo.com/goals/eat-well)

Sleep and energy: [Sleep better](https://agendolo.com/goals/sleep-better), [Wake up early](https://agendolo.com/goals/wake-up-early), [More energy](https://agendolo.com/goals/more-energy)

Mind: [Less stress](https://agendolo.com/goals/less-stress), [Burnout recovery](https://agendolo.com/goals/burnout-recovery), [Work-life balance](https://agendolo.com/goals/work-life-balance)

Work: [Stop procrastinating](https://agendolo.com/goals/stop-procrastinating), [Deep work](https://agendolo.com/goals/deep-work), [Side hustle](https://agendolo.com/goals/side-hustle), [Career growth](https://agendolo.com/goals/career-growth), [Networking](https://agendolo.com/goals/networking), [Creative work](https://agendolo.com/goals/creative-work)

Learn: [Learn a skill](https://agendolo.com/goals/learn-a-skill), [Study](https://agendolo.com/goals/study)

People and play: [Make friends](https://agendolo.com/goals/make-friends), [Family time](https://agendolo.com/goals/family-time), [Less screen time](https://agendolo.com/goals/less-screen-time)

### Roles

Who a framework is for, or not for.

Account Executive, Activist, Actor, AI Researcher, Animator, Architect, Athlete, Backend Developer, CEO, Civil Servant, Community Manager, Composer, Consultant, Content Creator, CTO, Customer Success Manager, Data Analyst, Data Engineer, Data Scientist, Designer, Developer Advocate, DevOps Engineer, Editor, Engineering Manager, Filmmaker, Founder, Freelancer, Frontend Developer, Full-Stack Developer, Game Developer, Growth Marketer, Head of State, Inventor, Investor, Machine Learning Engineer, Mathematician, Media Executive, Mobile Developer, Operations Manager, Painter, Parent, Philosopher, Poet, Politician, Producer, Product Designer, Product Manager, Product Marketing Manager, Product Owner, Project Manager, Psychoanalyst, QA Engineer, Sales Engineer, Scientist, Scrum Master, Security Engineer, Site Reliability Engineer, Software Developer, Solutions Architect, Student, Technical Recruiter, Technical Writer, TV Host, UX Researcher, Venture Capitalist, Writer

## Privacy and connected apps

A connected app acts as you. It can read your frameworks, edit your drafts and publish when you ask.

Disconnect an app any time in [Settings › MCP](https://agendolo.com/settings/mcp).