# Yahhi Aimyear MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.yahhi%2Faimyear-mcp
Registry id: `mcp-registry/io.github.yahhi/aimyear-mcp`
Status: live (checked 2026-11-22T17:07:24.430Z)

## Measurements (30 days)

- Uptime: 99.78%
- Checks: 841
- Outages (90 days): 3

## Install

```json
{
  "mcpServers": {
    "yahhi-aimyear-mcp-server": {
      "type": "http",
      "url": "https://mcp.aimyear.com/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http yahhi-aimyear-mcp-server https://mcp.aimyear.com/mcp
```

## Tools (60)

- `add_device`: Register a device token so server reminders (stand up, break over) can reach it. The phone app registers itself; use this for testing or a manual token.
- `add_move`: Record a move: one action toward the aim with no duration, e.g. a small fix the user described to you from the phone, or a message sent. task says what changed,
- `add_note`: Add a one-line note to a running session (this connection's, or session_id). May classify a session that was unclassified.
- `add_post`: Post the day's progress, only after the user explicitly said to post. text is the day's post as the user edited it, for Bluesky (default: the draft from get_pos
- `add_session`: Add past time that was not timed: minutes (ending now, or at end), or start+end as HH:MM on date. For calls, meetings, children, workout or gym, paid work, work
- `add_social_account`: Connect WIP (wip.co) or Bluesky so AimYear can post the day's progress there when the user says Post (Pro). WIP: api_key from wip.co settings. Bluesky: handle a
- `add_steps`: Add concrete steps to a milestone. A step is an action that fits a few work blocks ("email 10 people from the waitlist"), not "do marketing". Abstract steps are
- `check_goal_draft`: Check a goal (the aim for the year) that is not saved yet against the rubric (a countable metric with value today and target, or a done-or-not result you can ch
- `delete_agent`: Disconnect one agent: its sign-in for this account is deleted and it can no longer read or change anything until it connects again. Only on the user's explicit 
- `delete_auto_post`: Cancel an automatic WIP todo before it posts (the user said not to post it). A todo already on WIP stays there: the answer says so, with its link.
- `delete_device`: Remove a device so it stops receiving reminders.
- `delete_move`: Delete a move recorded by mistake. Pass move_id from list_moves. A plan item it ticked stays ticked.
- `delete_plan_item`: Remove one item from a day's plan. A routine item is skipped for that day only.
- `delete_session`: Delete a session, running or finished, so it no longer counts. Pass session_id from get_now or list_sessions; without it, only this connection's single running 
- `delete_social_account`: Disconnect a network and delete its saved login. Posts already made stay there.
- `delete_step`: Delete one step from the path.
- `edit_auto_post`: Change the text of an automatic WIP todo and post it now. Only when the user asked, with their words as they want them on WIP. Also posts an offered, waiting (s
- `edit_milestone`: Change one milestone: title, kind (count or steps), metric, target, due date, status or track. status=retired drops it without finishing; done or retired moves 
- `edit_plan_item`: Change one plan item: mark it done or not done, rename it, change its estimate, area or links, or make it the main step. done=true also completes its linked pat
- `edit_session`: Fix a session, running or finished: start and end (HH:MM on date; an end before the start means it ran past midnight), task, area, project, lever, step, plan it
- `edit_step`: Change one step: title, status (todo/doing/done), order, lever, estimate.
- `find_gaps`: Untimed stretches of 20+ minutes between the first and last session of a day. Ask the user what happened there.
- `find_leaks`: Where time leaks: comfortable goal work while the main step waited, overrides, unplanned work, gaps, switching, missed main steps, days without a plan. Default 
- `get_capacity`: Weekly time budget out of 168 hours: overhead, hours committed per area, focus windows, and what is still unaccounted for. Nothing is assumed.
- `get_commitments`: Recurring weekly time: commitments (school runs, training, classes), overhead (sleep, meals) and focus windows.
- `get_goal`: The one yearly goal (the user's aim for the year): kind (count or done), metric, starting value, current value, target, deadline, progress, levers (hard/comfort
- `get_insights`: Week (the last 7 days) or month (the last 30 days) ending on to (default today): minutes per day on the aim, other work and life; hard vs comfortable share of a
- `get_now`: What is happening now: running sessions with attention shares, the timer, today's main step, today's minutes, the streak and a one-line nudge.
- `get_path`: Milestones with kind, progress (recorded value or steps done), pace (ahead/on_pace/behind) and their steps. With tracks: tracks[], each with its current_milesto
- `get_plan`: The plan for a day (default today).
- `get_planning_context`: Everything needed to plan a day: goal and pace, next_steps, yesterday's summary and undone items, week balance, days since a hard lever. Defaults to tomorrow. T
- `get_post_draft`: The day's progress drafted from the record. text is the day's post (Bluesky): it leads with what moved toward the aim (the day's session summaries and moves, in
- `get_pro_link`: A link where the user buys AimYear Pro on the web, yearly or monthly, without the app: for someone who uses AimYear only through an agent. Use it when the user 
- `get_routines`: Routines: small steps that repeat on fixed weekdays, e.g. "talk with one person on Reddit", or that count up to a number a week, e.g. "talk to 5 people a week",
- `get_settings`: Timezone, the default workplace (desktop or mobile; reminders go to every registered device either way), timer settings, which networks get progress posts (post
- `list_agents`: Agents connected to this AimYear account (Claude, ChatGPT, Claude Code, the AimYear app…): name, client_id, when it connected and when it was last active. curre
- `list_auto_posts`: The automatic WIP todos of a day (default today), each from a session or move on a project marked public: queued (post_at, still cancellable), posted (url), can
- `list_devices`: Which devices can receive reminders, and when each was last seen.
- `list_moves`: Moves in a date range (default the last 7 days), with ids, whether each was toward the aim and on the hard part.
- `list_sessions`: Sessions in a date range (default the last 7 days), with ids, optionally filtered by area or project.
- `list_social_accounts`: Connected networks (handle, since when), which of them get progress posts, and whether the user has Pro. Never returns any key or password.
- `list_wip_projects`: The user's own WIP (wip.co) projects with their hashtags, read through their saved WIP login, and which AimYear project or lever carries each hashtag; plus the 
- `next_steps`: Open steps of the current milestone (of every track, taken in turns, each step with its track), hard-lever steps first: the candidates for today's main step. An
- `record_progress`: Record the current value of the goal metric ("I now have 4 customers"), or of a countable milestone when milestoneId is given ("I have talked to 7 people"). For
- `set_commitments`: Replace the list of recurring weekly commitments. days are ISO weekdays 1=Mon..7=Sun; use timesPerWeek instead when there are no fixed days. Pass existing ids t
- `set_day_mode`: Tracking for a day: full (everything recorded, the default) or off (timer and reminders only, nothing stored, no plan required).
- `set_goal`: Save the yearly goal (the aim), or replace it with the next one. Rejects with problems[] if the rubric fails. Keeps levers and projects. area is which of the fi
- `set_levers`: Replace the list of levers: the recurring kinds of goal work. At least one must be kind=hard (the work the user avoids). keywords/repos are hints for classifyin
- `set_milestones`: Replace the list of ordered milestones under the goal (2–6, or up to 6 per track), each countable (metric and target) or measured by its steps, with a due date 
- `set_plan`: Replace the plan for a day. Exactly one item must have isMainStep=true (the step toward the goal), ideally linked by stepId from next_steps and on a hard lever.
- `set_projects`: Replace the list of other projects (paid work, other products, life routines), so their sessions count as other work or life, not goal work. Pass the whole list
- `set_routines`: Replace the list of routines: small steps that repeat on fixed weekdays. From today on, each one appears as a plan item on its days; tick it with edit_plan_item
- `set_settings`: Change any of: timezone (IANA name, e.g. Europe/Madrid; it sets where each day starts and ends), workplace (the default for sessions; reminders go to every devi
- `set_tracks`: Replace the tracks of the path: 0 to 3 different ways to reach the same aim (e.g. two products that could each earn the target), each with its own milestones an
- `split_attention`: Set attention weights of the running sessions at once, e.g. {"abc": 0.7, "def": 0.3}. Applies to the whole session, or with from_now only from now on (the user 
- `start_session`: Start a session of work and, if none is running, the timer. Returns a verdict: ok | stop | plan_first. On "stop" NO session is created: relay the message, ask t
- `stop_session`: Stop a running session with a summary and outcome, when the user says they are done or finished. Pass session_id from get_now; without it, only this connection'
- `stop_timer`: Stop the timer ("pause", "stop", "stand up") and every running session with it. There is no paused state: resuming starts a new session. Pass summary and outcom
- `summarize_day`: Full summary of a day: wall and attention minutes per area, classification and lever, sessions, gaps, overlaps, overrides.
- `summarize_week`: A week, Monday to Sunday (to today for the current week): main-step days, goal share, hard share, area balance, overrides, streak, milestone pace.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
