NestDaddy

Schoolpass Mcp

io.github.chrischall/schoolpass-mcp · v1.1.1

SchoolPass for Claude — students, arrival/dismissal calendar, pickup changes, and school info

Connect Runs on your machine

Terminal
claude mcp add schoolpass-mcp -e SCHOOLPASS_EMAIL=<SCHOOLPASS_EMAIL> -e SCHOOLPASS_PASSWORD=<SCHOOLPASS_PASSWORD> -e SCHOOLPASS_SCHOOL_CODE=<SCHOOLPASS_SCHOOL_CODE> -e SCHOOLPASS_API_HOST=<SCHOOLPASS_API_HOST> -e SCHOOLPASS_TIMEZONE=<SCHOOLPASS_TIMEZONE> -e SCHOOLPASS_SESSION_CACHE=<SCHOOLPASS_SESSION_CACHE> -e SCHOOLPASS_SESSION_FILE=<SCHOOLPASS_SESSION_FILE> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "schoolpass-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "SCHOOLPASS_EMAIL": "<SCHOOLPASS_EMAIL>",
        "SCHOOLPASS_PASSWORD": "<SCHOOLPASS_PASSWORD>",
        "SCHOOLPASS_SCHOOL_CODE": "<SCHOOLPASS_SCHOOL_CODE>",
        "SCHOOLPASS_API_HOST": "<SCHOOLPASS_API_HOST>",
        "SCHOOLPASS_TIMEZONE": "<SCHOOLPASS_TIMEZONE>",
        "SCHOOLPASS_SESSION_CACHE": "<SCHOOLPASS_SESSION_CACHE>",
        "SCHOOLPASS_SESSION_FILE": "<SCHOOLPASS_SESSION_FILE>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "schoolpass-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "SCHOOLPASS_EMAIL": "<SCHOOLPASS_EMAIL>",
        "SCHOOLPASS_PASSWORD": "<SCHOOLPASS_PASSWORD>",
        "SCHOOLPASS_SCHOOL_CODE": "<SCHOOLPASS_SCHOOL_CODE>",
        "SCHOOLPASS_API_HOST": "<SCHOOLPASS_API_HOST>",
        "SCHOOLPASS_TIMEZONE": "<SCHOOLPASS_TIMEZONE>",
        "SCHOOLPASS_SESSION_CACHE": "<SCHOOLPASS_SESSION_CACHE>",
        "SCHOOLPASS_SESSION_FILE": "<SCHOOLPASS_SESSION_FILE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "schoolpass-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "SCHOOLPASS_EMAIL": "<SCHOOLPASS_EMAIL>",
        "SCHOOLPASS_PASSWORD": "<SCHOOLPASS_PASSWORD>",
        "SCHOOLPASS_SCHOOL_CODE": "<SCHOOLPASS_SCHOOL_CODE>",
        "SCHOOLPASS_API_HOST": "<SCHOOLPASS_API_HOST>",
        "SCHOOLPASS_TIMEZONE": "<SCHOOLPASS_TIMEZONE>",
        "SCHOOLPASS_SESSION_CACHE": "<SCHOOLPASS_SESSION_CACHE>",
        "SCHOOLPASS_SESSION_FILE": "<SCHOOLPASS_SESSION_FILE>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
SCHOOLPASS_EMAIL
Optional
Your SchoolPass parent account email address.
SCHOOLPASS_PASSWORD
Optional, secret
Your SchoolPass parent account password.
SCHOOLPASS_SCHOOL_CODE
Optional
The numeric school id (AppCode) SchoolPass uses to select your school.
SCHOOLPASS_API_HOST
Optional
Optional regional API host override (default busapi-east16-ss.school-pass.net).
SCHOOLPASS_TIMEZONE
Optional
The school's IANA timezone (e.g. America/New_York), used for the "today" default of the calendar and pickup-change reads. Defaults to the server's local zone; set it when the server runs elsewhere (a hosted server runs in UTC, so evening defaults would otherwise point at tomorrow).
SCHOOLPASS_SESSION_CACHE
Optional
Set to false to disable the on-disk session cache and re-authenticate on every process start. Defaults to enabled.
SCHOOLPASS_SESSION_FILE
Optional
Absolute path for the session cache file. Defaults to $MCP_DATA_DIR/.schoolpass-mcp/session.json.

Details

Package[email protected] (NPM, stdio)
First published4 Nov 2026
Last updated4 Nov 2026
Registry nameio.github.chrischall/schoolpass-mcp

More productivity servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.