Cal Auto Python MCP Server

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.

claude mcp add cal-auto-python -e 'GITHUB_TOKEN=<GITHUB_TOKEN>' -e 'GITHUB_PROJECT_ID=<GITHUB_PROJECT_ID>' -e 'CAL_AUTO_TIMEZONE=<CAL_AUTO_TIMEZONE>' -- uvx cal-auto-python

{
  "mcpServers": {
    "cal-auto-python": {
      "command": "uvx",
      "args": [
        "cal-auto-python"
      ],
      "env": {
        "CAL_AUTO_TIMEZONE": "<CAL_AUTO_TIMEZONE>",
        "GITHUB_PROJECT_ID": "<GITHUB_PROJECT_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

[mcp_servers.cal-auto-python]
command = "uvx"
args = ["cal-auto-python"]
env = { GITHUB_TOKEN = "<GITHUB_TOKEN>", GITHUB_PROJECT_ID = "<GITHUB_PROJECT_ID>", CAL_AUTO_TIMEZONE = "<CAL_AUTO_TIMEZONE>" }

{
  "mcpServers": {
    "cal-auto-python": {
      "command": "uvx",
      "args": [
        "cal-auto-python"
      ],
      "env": {
        "CAL_AUTO_TIMEZONE": "<CAL_AUTO_TIMEZONE>",
        "GITHUB_PROJECT_ID": "<GITHUB_PROJECT_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

{
  "servers": {
    "cal-auto-python": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cal-auto-python"
      ],
      "env": {
        "CAL_AUTO_TIMEZONE": "<CAL_AUTO_TIMEZONE>",
        "GITHUB_PROJECT_ID": "<GITHUB_PROJECT_ID>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}

Put your own values in place of <GITHUB_TOKEN> (GitHub personal access token used to query the GitHub Project), <GITHUB_PROJECT_ID> (GitHub Projects V2 node ID of the board to read), <CAL_AUTO_TIMEZONE> (IANA timezone name used to schedule events, e.g. Europe/Lisbon). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: CAL_AUTO_CONFIG_DIR (Directory holding Google OAuth credentials and token. Defaults to the platform config directory), CAL_AUTO_WORKING_DAY_START (Start of the working day as HH:MM. Defaults to 09:00), CAL_AUTO_WORKING_DAY_END (End of the working day as HH:MM. Defaults to 17:00), CAL_AUTO_CALENDAR_ID (Google Calendar ID to schedule events into. Defaults to primary), CAL_AUTO_TASK_LIST_ID (Google Tasks list ID to create tasks in. Defaults to @default), CAL_AUTO_ATTENDEES (Comma-separated email addresses to invite to scheduled events), CAL_AUTO_SCHEDULABLE_STATUSES (Comma-separated GitHub Project status names to schedule. Defaults to Backlog), CAL_AUTO_COUNT_ALL_DAY_EVENTS (Whether all-day events count against free/busy slots. Defaults to false).