Skip to content
MCP server

Cal Auto Python

Schedule a GitHub Projects backlog into Google Calendar, as a CLI or an MCP server.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

About Cal Auto Python

Cal Auto Python is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "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>"
      }
    }
  }
}

Configuration

  • GITHUB_TOKENGitHub personal access token used to query the GitHub Project.Required
  • GITHUB_PROJECT_IDGitHub Projects V2 node ID of the board to read.Required
  • CAL_AUTO_TIMEZONEIANA timezone name used to schedule events, e.g. Europe/Lisbon.Required
  • CAL_AUTO_CONFIG_DIRDirectory holding Google OAuth credentials and token. Defaults to the platform config directory.
  • CAL_AUTO_WORKING_DAY_STARTStart of the working day as HH:MM. Defaults to 09:00.
  • CAL_AUTO_WORKING_DAY_ENDEnd of the working day as HH:MM. Defaults to 17:00.
  • CAL_AUTO_CALENDAR_IDGoogle Calendar ID to schedule events into. Defaults to primary.
  • CAL_AUTO_TASK_LIST_IDGoogle Tasks list ID to create tasks in. Defaults to @default.
  • CAL_AUTO_ATTENDEESComma-separated email addresses to invite to scheduled events.
  • CAL_AUTO_SCHEDULABLE_STATUSESComma-separated GitHub Project status names to schedule. Defaults to Backlog.
  • CAL_AUTO_COUNT_ALL_DAY_EVENTSWhether all-day events count against free/busy slots. Defaults to false.

Pricing

Open source

Cal Auto Python FAQ

Is Cal Auto Python free?

Yes. Cal Auto Python is open source, so you can use and self-host it for free.

How do I add Cal Auto Python to Claude Code?

Run this command in your terminal: claude mcp add cal-auto-python --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env GITHUB_PROJECT_ID='<GITHUB_PROJECT_ID>' --env CAL_AUTO_TIMEZONE='<CAL_AUTO_TIMEZONE>' -- uvx cal-auto-python

What are the best alternatives to Cal Auto Python?

The closest alternatives to Cal Auto Python are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Cal Auto Python

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media