Connect Yearmark to your AI
The short version
- Yearmark has a hosted connector, so the AI you already use can read your year and plan it with you in plain conversation.
- It signs in with your Yearmark account. New accounts get a free week with no card, then need a plan.
- Each account only ever sees its own year, or the year its household shares.
- Every change your AI makes is logged, so you can always see what changed and where it came from.
The connector link
https://app.yearmarkcalendar.com/api/mcpIt's a remote MCP server over Streamable HTTP. Paste it wherever your AI asks for a custom connector URL.
Add it to your AI
Claude
Open Customize, then Connectors. Click +, then Add custom connector. Name it Yearmark, paste the link and click Add. Sign in to Yearmark when it asks. In any chat, click +, open Connectors and switch Yearmark on. Works on every Claude plan, including free.
ChatGPT
Open Settings, then Apps, and turn on Developer mode. Click Create, name it Yearmark and paste the link. Choose sign in, let it scan the tools, then click Create. Sign in to Yearmark when it asks. In any chat, click + and pick Yearmark. Adding blocks needs a ChatGPT plan with full connector support.
Meta Muse
Coming soon.
How sign-in works
The connector uses OAuth 2.1 with PKCE. Your AI never sees your password.
- Discovery follows the MCP spec. A request without a token gets a 401 that points to
/.well-known/oauth-protected-resource, which points to/.well-known/oauth-authorization-server. - Clients register themselves through dynamic client registration at
/oauth/register. They're public clients, so there's no client secret. - Authorization code flow only, with the S256 code challenge. Plain challenges are refused.
- Scopes are
year:readandyear:write. - Access tokens last 30 days. There are no refresh tokens, so after 30 days your AI asks you to sign in again.
When you connect, Yearmark opens its own sign-in page. If you already have an account, sign in and click Allow access. If you're new, you can create an account from that page and start your free week, and you're brought back to finish connecting. When the free week or your plan ends, you're sent to choose a plan before access is granted.
What your AI can do
37 tools, grouped by job. "Reads" only looks. "Changes" adds to or edits your year.
See the year
get_year | Every block in a year, plus the named seasons. | Reads |
show_year | Draws the year as a picture, the same grid the app shows. | Reads |
find_blocks | Searches by text, year, category or mark. Used before any edit, so the right block changes. | Reads |
review_year | How the year has gone so far, what was worth repeating, what wasn't, and goal progress. | Reads |
history | What changed on a block or across the calendar, with the value before and after, and whether it came from the app or a connector. | Reads |
Add and change events
create_block | Adds an event, one day or a run of days, with a time if it has one. | Changes |
update_block | Changes a block's name, dates, times or category. | Changes |
create_series | Adds a repeating event, like a weekly class. Each one is its own block. | Changes |
end_series | Stops a repeating event from a date on and keeps the ones that already happened. | Changes |
set_tentative | Pencils a block in, or inks it. | Changes |
set_duty | Marks a block as someone else's ask rather than your own choice. | Changes |
delete_block | Removes a block for good. Your AI is told to confirm with you first. | Changes |
Remember how it went
mark_block | Marks a block as worth repeating or not again. | Changes |
set_note | Adds a note on why something went the way it did. | Changes |
Plan ahead
repeat_next_year | Puts a block on next year's calendar right away. | Changes |
plan_carry | Plans to do something again on new dates, in any future year. | Changes |
bring_forward | Turns everything planned for a year into real blocks. Safe to run twice. | Changes |
Goals, seasons and categories
get_goals | Progress on the year's goals, counted from the blocks themselves. | Reads |
set_goal | Creates or changes a goal. | Changes |
delete_goal | Removes a goal. Your AI is told to confirm with you first. | Changes |
set_seasons | Names the stretches of the year, like school year or summer. | Changes |
list_categories | The year's categories, with their names and colors. | Reads |
save_category | Adds, renames, recolors or hides a category. | Changes |
Plan with your household
list_requests | Asks waiting between the people sharing the year, and who's in it. | Reads |
ask | Asks someone sharing your year about a plan before it's final. It's penciled in until they answer. | Changes |
answer_request | Answers an ask waiting on you, only with what you actually said. | Changes |
withdraw_request | Takes back an ask nobody has answered yet. | Changes |
family_notes | The shared board for things with no date. | Reads |
add_family_note | Puts a note on the shared board. | Changes |
update_family_note | Edits, pins, ticks off or deletes a note. | Changes |
Find a time with other people
availability_links | Your shareable availability pages, where anyone picks a free time without an account. | Reads |
save_availability_link | Creates or changes an availability page. | Changes |
bookings | Times people booked on your pages. New ones wait for your approval. | Reads |
answer_booking | Approves or declines a booking, only when you say so. The person gets an email either way. | Changes |
group_plans | Times proposed to a group, with who said yes, maybe or no. | Reads |
create_group_plan | Proposes a few times to a group and returns one link to send them. Nobody needs an account. | Changes |
pick_group_plan | Settles a group plan on one time. It becomes a real block and everyone who left an email is told. | Changes |
Built to be safe with your year
- Every edit names a block by its id, and your AI is told to look it up first, so two blocks with the same name don't get mixed up.
- Your AI is told to ask you before deleting a block or a goal.
- Your AI is told to answer asks and bookings only with what you actually said, never a guess.
- Every change is recorded with where it came from, the app or a connector, and what it was before.
Plans
Your first week is free, with no card needed. After that it's $5 a month, or $36 a year. One plan covers a household of up to 6 people, and everyone can use the app, their own AI, or both. No credits and no metered usage. See the refund policy for how refunds work.
Help
Something not working, or a question about the connector? Email hello@yearmarkcalendar.com.