mcpbeat Sign in

when-free MCP Server

by yauhenbichel Your server? Claim it
local only

when-free runs on your own machine — the client starts it, so there is no endpoint to ping. 49 installs a week from pypi. Last commit 11 Oct 2026.

Which days and times am I free? Reads your calendar feeds and answers with the slots you can offer.

Installs per day peak 314 · avg 30 · -57% w/w
a month agotoday
49
Installs / week
pypi · when-free
0
Stars
0 open issues
11 Oct 2026
Last commit
from GitHub
Apache-2.0
License
Python

What the code does

We read the source, 15 h ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] src/whenfree/agents/__init__.py:1, [пакет] src/whenfree/agents/mcp.py:1, [пакет] src/whenfree/agents/tools.py:1
этот файл ставится пользователю, но в репозитории его нет
        done = subprocess.run(argv, input=stdin, capture_output=True, text=True, timeout=timeout)

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add when-free -- uvx when-free
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "when-free": {
      "command": "uvx",
      "args": [
        "when-free"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.when-free]
command = "uvx"
args = ["when-free"]
.cursor/mcp.json
{
  "mcpServers": {
    "when-free": {
      "command": "uvx",
      "args": [
        "when-free"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "when-free": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "when-free"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: WHENFREE_CALENDARS (Private iCal addresses of your calendars, comma-separated. Optional if you saved them with `whenfree add`), WHENFREE_TZ (Time zone for answers, like Europe/London. Default: the computer's).

Alternatives to when-free

same job, measured the same way
SurfacedBy AI Visibility & GEO Audit
by surfacedby

Free AI visibility and GEO audit: see what AI reads on your site and whether its answers cite you.

5 tools answering
The Pantry Butler
by thepantrybutler

Answers 'what can I cook tonight?' from your own saved recipes and what's really in your kitchen.

6 tools answering
Apple Calendar
by mgcrea

Search, read and act on Apple Calendar — ranges, free-time lookup, writes off by default

966 installs/wk local only
Apple Calendar
by mp-consulting

Read, search and plan Apple Calendar on macOS via EventKit: free time, undo, you approve deletes

local only
Toddyi
by toddyi-app

Tasks, calendar and study materials in Toddyi: search, read and plan with your tasks.

answering
Calendar Ics Reader Events Freebusy Conflicts
by theluckystrike

Read the .ics your calendar exports: events in a window, free-busy, double bookings, export.

12 tools answering
Appointment
by theluckystrike

Read your .ics calendar for appointments, free-busy windows and conflicts.

12 tools local only
Nis2 Incident Runbook Lint
by jmshinhwa

Reads your incident-response runbook and says which of the three Article 23 clocks it gets wrong

47 installs/wk local only

when-free — questions

Answers built from our own checks of this server.

Why is there no uptime for when-free?
when-free runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package when-free was installed 49 times last week.
How do I connect when-free?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls when-free straight from pypi; nothing to host, nothing to sign up for.
How many people use when-free?
The pypi package when-free was installed 49 times in the last week. Week over week that is -57%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is when-free open source?
Yes — it is published under the Apache-2.0 licence, written in Python and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.