when-free MCP server
io.github.YauhenBichel/when-free·v0.4.1Which days and times am I free? Reads your calendar feeds and answers with the slots you can offer.
0 stars91 downloads/wk
Reviews
Write oneNobody has reviewed when-free yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
when-free tools
No tool declarations could be read from the package source. They show once the server is installed.
Public scan report
scanner v0.1.10 · 2026-10-09 · same rubric, same numbers if you re-run it
- Code scan40 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How when-free compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 60% of 1,299 Productivity servers
- Downloads a week
- 91
- more than 54% of 427 Productivity servers with a package
Install when-free in Claude Code, Cursor or VS Code
claude mcp add when-free -- uvx when-free
What the publisher says
From the when-free repository's README, as published. We do not edit it. Read it on GitHub
when-free
Someone asks when you're free. This reads your calendar and gives you the answer, ready to paste.
<!-- mcp-name: io.github.YauhenBichel/when-free -->
- Paste the message, get the slots. It reads "Tuesday or Wednesday next week, between 10am and 4pm" and answers for exactly those days and hours.
- Works with Google, Outlook and iCloud calendars, or any .ics file. Several calendars at once.
- Private. It runs on your computer, needs no account and no API key, and never changes your calendar.
- Works from your AI tools too: Claude, Cursor and other MCP clients, Open WebUI, n8n, Shortcuts, scripts.
- And on your other devices: phones, tablets and watches, Home Assistant (and Alexa, Google Home, Siri through it), and the menu bar or status bar of macOS, Linux and Windows.
Contents
Try it · Add your calendar · Everyday use · Reading a message · Use it from other tools · Other devices · Privacy · Settings · What counts as busy · Limits · Problems
Try it in a minute
With uv, nothing to install first:
uvx when-free demoTo keep it (needs Python 3.11 or newer):
uv tool install when-free # or: pipx install when-free
whenfree demoUsing Claude Desktop? You can skip all of this: install the one-click extension.
whenfree demo makes up a calendar for next week and answers a recruiter's message from it. It reads none of your data and saves nothing:
> Hi! Thanks for applying. Could you share a few times on Tuesday, Wednesday or Thursday next week,
> between 10am and 4pm? The interview takes about an hour.
Free between 10:00 and 16:00 (Europe/London), slots of 60+ minutes, 15-minute buffer around events:
- Tue 13 Oct: 11:45–12:45, 14:15–16:00
- Wed 14 Oct: 12:15–14:15
- Thu 15 Oct: 13:15–14:45Add your calendar
- Copy your calendar's private address. It's a link that ends in .ics:
- Run whenfree add and paste it. The address isn't shown while you paste. It's checked first, and saved only if it works:
$ whenfree add
Paste the address and press Enter (it is not shown):
Added 'personal': 412 events, 9 block time in the next 14 days.
Saved in /Users/you/.config/when-free/config.toml, readable only by you. Now run: whenfree- Run whenfree. You'll see your free time for the next working days.
On a Mac, pbpaste | whenfree add takes the address straight from the clipboard.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
when-free: common questions
- Is when-free MCP server safe?
- Mostly: it is graded B (83/100). Read the when-free safety report
- How do I install when-free?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does when-free need an API key?
- Yes. The registry entry asks for
WHENFREE_CALENDARS. - Is when-free maintained?
- The last commit was 26 days ago (2026-10-09). The latest release is v0.4.1.
- What can I use instead of when-free?
- Servers from other publishers that do the same job: Agent-Native Calendar MCP server, AIquila — Nextcloud MCP Server and Intervals Icu MCP server.
- How does when-free compare with other Productivity MCP servers?
- safety score 83/100 (higher than 60% of 1,299 Productivity servers); downloads a week 91 (more than 54% of 427 Productivity servers with a package). Full comparison.
Alternatives to when-free
Same job from other publishers: the closest match first, then the best rated.
- Agent-Native CalendarAgent-Native Google Calendar - manage events, sync, and public bookingnot reviewedEstablishedA
- AIquila — Nextcloud MCP ServerNextcloud MCP server — 345 tools: files, calendar, contacts, mail, Talk, Deck, photos, maps, notesnot reviewedEstablishedC
- Intervals IcuRead/write Intervals.icu MCP server: activities, wellness, calendar, gear, and workouts.not reviewedEstablishedB
- iCloud MCPApple Mail, Calendar, Contacts, Reminders, Notes, Messages and Safari via AppleScript or iCloudnot reviewedEstablishedB
MuNews, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.not reviewedEstablishedB