io.github.Yahhi/aimyear-mcp

up checked 2026-11-11T02:37:53.054Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

AimYear

Publisher-provided description

Accountability partner in your agent: one yearly aim, one main step a day, a timer your agent runs.

Summary by lookupd

Tracks one yearly goal with milestones, daily plans, routines and time budgets, and records progress and session timing.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http aimyear https://mcp.aimyear.com/mcp

Codex, remote (streamable-http)

codex mcp add aimyear --url https://mcp.aimyear.com/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "aimyear": {
      "url": "https://mcp.aimyear.com/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 59)

Publisher-provided text

• get_goal The one yearly goal: kind (count or done), metric, starting value, current value, target, deadline, progress, levers (hard/comfortable) and other projects. Call
• check_goal_draft Check a goal that is not saved yet against the rubric (a countable metric with value today and target, or a done-or-not result you can check yes or no; deadline
• set_goal Save the yearly goal, or replace it with the next one. Rejects with problems[] if the rubric fails. Keeps levers and projects. area is which of the five life ar
• 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_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_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
• 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
• 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_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
• 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
• 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
• edit_step Change one step: title, status (todo/doing/done), order, lever, estimate.
• delete_step Delete one step from the path.
• 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.
• get_commitments Recurring weekly time: commitments (school runs, training, classes), overhead (sleep, meals) and focus windows.
• 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
• 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_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_plan The plan for a day (default today).
• 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.
• 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
• 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",
• 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
• delete_plan_item Remove one item from a day's plan. A routine item is skipped for that day only.
• set_day_mode Tracking for a day: full (everything recorded, the default) or off (timer and reminders only, nothing stored, no plan required).
• 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.
• 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
• add_note Add a one-line note to a running session (this connection's, or session_id). May classify a session that was unclassified.
• 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
• stop_session Stop a running session with a summary and outcome. Pass session_id from get_now; without it, only this connection's single running session is stopped, never ano

Details

• Version: 0.12.1
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 339 ms
• First indexed: 2026-11-01T09:18:22.991Z
• Last seen in registry: 2026-11-08T01:17:18.203Z
• Repository: https://github.com/Yahhi/aimyear-mcp
• Website: https://aimyear.com

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.Yahhi/aimyear-mcp.svg)](https://lookupd.com/servers/io.github.Yahhi/aimyear-mcp)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp