MCP server

AimYear

io.github.Yahhi/aimyear-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

52

Token cost

About 10,701 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.aimyear-mcp]
url = "https://mcp.aimyear.com/mcp"

Gemini CLI

{"mcpServers":{"aimyear-mcp":{"httpUrl":"https://mcp.aimyear.com/mcp"}}}

Cursor

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

VS Code

{"servers":{"aimyear-mcp":{"type":"http","url":"https://mcp.aimyear.com/mcp"}}}

Antigravity

agy mcp add aimyear-mcp https://mcp.aimyear.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"aimyear-mcp","server_url":"https://mcp.aimyear.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"aimyear-mcp","server_url":"https://mcp.aimyear.com/mcp"}

Tools

• add_device ~134 tokens
  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_note ~199 tokens
  Add a one-line note to a running session (this connection's, or session_id). May classify a session that was unclassified.
• add_post ~229 tokens
  Post the day's progress, only after the user explicitly said to post. text is the draft as the user edited it (default: the draft from get_post_draft). Goes to the networks chosen in settings, or the ones given. A network where the user already posted that day themselves is skipped. Each day goes to
• add_session ~454 tokens
  Add past time that was not timed: minutes (ending now, or at end), or start+end as HH:MM on date. For calls, children, workout, paid work, or work done away from the agent. Apps replaying a queued entry pass op_id, so a retry does not count the time twice.
• add_social_account ~268 tokens
  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 and an app password (Settings → Privacy and security → App passwords), never the account password. The login is checked, stored encrypted and
• add_steps ~286 tokens
  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 rejected. Put a hard-lever step first; preparation only where it blocks it (warns otherwise).
• check_goal_draft ~319 tokens
  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 within 12 months; pace per week). Changes nothing. Returns problems[] and next_question: loop until problems is empty, then call set_goal.
• delete_agent Deletes data · ~121 tokens
  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 request. client_id from list_agents.
• delete_device Deletes data · ~68 tokens
  Remove a device so it stops receiving reminders.
• delete_plan_item Deletes data · ~110 tokens
  Remove one item from a day's plan. A routine item is skipped for that day only.
• delete_session Deletes data · ~205 tokens
  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 session is deleted, never another one.
• delete_social_account Deletes data · ~87 tokens
  Disconnect a network and delete its saved login. Posts already made stay there.
• delete_step Deletes data · ~63 tokens
  Delete one step from the path.
• edit_milestone ~307 tokens
  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 its track to the next milestone. Its steps are kept.
• edit_plan_item ~370 tokens
  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 path step. For a weekly routine, count says how many units this tick did (talked to 2 people today). For a routine, level minimum says only its
• edit_session ~445 tokens
  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 item, summary, outcome, attention share, weight. It is classified again after a change. Use it when a timer was forgotten or a session was lab
• edit_step ~155 tokens
  Change one step: title, status (todo/doing/done), order, lever, estimate.
• find_gaps ~103 tokens
  Untimed stretches of 20+ minutes between the first and last session of a day. Ask the user what happened there.
• find_leaks ~152 tokens
  Where time leaks: comfortable goal work while the main step waited, overrides, unplanned work, gaps, switching, missed main steps, days without a plan. Default the last 7 days.
• get_capacity ~81 tokens
  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 ~73 tokens
  Recurring weekly time: commitments (school runs, training, classes), overhead (sleep, meals) and focus windows.
• get_goal ~91 tokens
  The one yearly goal: kind (count or done), metric, starting value, current value, target, deadline, progress, levers (hard/comfortable) and other projects. Call first in most flows.
• get_insights ~205 tokens
  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 aim time; an hour × weekday heatmap of aim minutes (6:00–23:00, Mon–Sun) with its hard part and the peak; main-step days; and comebacks (acti
• get_now ~80 tokens
  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 ~135 tokens
  Milestones with kind, progress (recorded value or steps done), pace (ahead/on_pace/behind) and their steps. With tracks: tracks[], each with its current_milestone_id (every track has its own current milestone); current_milestone_id is then the first open one in list order. Without tracks, current_mi
• get_plan ~81 tokens
  The plan for a day (default today).
• get_planning_context ~130 tokens
  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. The agent plans; then call set_plan.
• get_post_draft ~166 tokens
  The day's progress post drafted from the record (aim and progress, main step done or not, minutes on the aim and on hard work, routines, comebacks), at most 300 characters, ending with aimyear.com; and per network whether it is ready, already posted, or skipped because the user already posted there
• get_routines ~153 tokens
  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", each with an optional bad-day minimum. The server adds them to each matching day's plan, so every device and agent sees the same checks. Wi
• get_settings ~73 tokens
  Timezone, where reminders go (desktop or mobile), timer settings, and which networks get progress posts (post_to).
• list_agents ~93 tokens
  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. current marks the one calling.
• list_devices ~59 tokens
  Which devices can receive reminders, and when each was last seen.
• list_sessions ~164 tokens
  Sessions in a date range (default the last 7 days), with ids, optionally filtered by area or project.
• list_social_accounts ~83 tokens
  Connected networks (handle, since when), which of them get progress posts, and whether the user has Pro. Never returns any key or password.
• next_steps ~100 tokens
  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.
• record_progress ~213 tokens
  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 a done-or-not goal, 1 marks it done. One value per date: calling again for the same date corrects it. Says when the target is reached; a co
• set_commitments ~464 tokens
  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 to keep them.
• set_day_mode ~128 tokens
  Tracking for a day: full (everything recorded, the default) or off (timer and reminders only, nothing stored, no plan required).
• set_goal ~325 tokens
  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 areas the goal belongs to.
• set_levers ~212 tokens
  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 classifying sessions from their task text. Pass existing ids to keep them.
• set_milestones ~366 tokens
  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 before the goal deadline; due dates in order within a track. Pass each existing id, or that milestone's steps are deleted. To change one mil
• set_plan ~279 tokens
  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. Warns when no item is on a hard lever. Other items: paid work, family, workout, etc. with their area. Items that stay keep their done state
• set_projects ~216 tokens
  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: leave one out to remove it, change its name or hints to edit it. Pass existing ids to keep them.
• set_routines ~413 tokens
  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, skip it for one day with delete_plan_item. set_plan keeps them. days are ISO weekdays 1=Mon..7=Sun, default every day. perWeek makes it a
• set_settings ~260 tokens
  Change any of: timezone (IANA name, e.g. Europe/Madrid; it sets where each day starts and ends), workplace for reminders, stand-up interval workMin, breakMin, longBreakEvery, longBreakMin, standup on/off, post_to (networks for progress posts).
• set_tracks ~268 tokens
  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 and current milestone. reach says how this track alone would reach the aim. milestoneIds puts those milestones into the track, in that order.
• split_attention ~126 tokens
  Set attention weights of the running sessions at once, e.g. {"abc": 0.7, "def": 0.3}. Applies to the whole session. For a finished session use edit_session.
• start_session ~715 tokens
  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 the user; if they insist, call again with override=true. Several sessions may run at once (two terminals) and share attention by weight. Apps
• stop_session ~503 tokens
  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 another one. The timer keeps running for other sessions. outcome=done completes the linked plan item or path step. Without end_at or op_id it r
• stop_timer ~150 tokens
  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 outcome to save them on the sessions it closes, or call stop_session first. Returns the break length.
• summarize_day ~107 tokens
  Full summary of a day: wall and attention minutes per area, classification and lever, sessions, gaps, overlaps, overrides.
• summarize_week ~114 tokens
  A week, Monday to Sunday (to today for the current week): main-step days, goal share, hard share, area balance, overrides, streak, milestone pace.

Browse

• GitHub tools
• Email
• Social media
• To-do lists
• GitHub and code hosting

Related MCP servers

• Loafy: Sourdough Bread Baking
  Sourdough baking: dough calculators, a bake planner, The Sourdough Framework and your bake journal
• Befana Recipes
  Ad-free recipes with amounts in every step: search, scale, plan meals, build shopping lists.
• Sell to State
  Government tenders, contract awards, buyers and suppliers from official sources in 60+ countries.
• Japan Trade Statistics (customs data)
  Japan export and import customs statistics (Ministry of Finance) by code. No API key required.
• Kitchen Timer
  Plan a meal and run kitchen timers that ring on your phone. No sign-in.
• ALUZZA MARINE: Japan boat trade and tide tables
  Japan boat trade 2011-2025, tide tables for 239 ports and past monthly weather near ports (JMA).
• Eggtimer.app
  Shareable timer links for countdowns, clock times, Pomodoro, Tabata and step recipes. No account.
• ELC Conference 2027: tickets, perks, partnerships
  ELC Conference 2027, Prague: tickets, attendee perks and partnership quotes from your AI assistant.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.Yahhi/aimyear-mcp.svg)](https://aptlynx.net/servers/io.github.Yahhi/aimyear-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents