Skip to main content
Glama

ParentSquare MCP

An MCP server that gives Claude read access to your own ParentSquare parent account — school posts, calendars, messages, the staff directory, signups, forms, payments and files.

School calendars and flyers are very often posted as image or PDF attachments rather than as calendar entries. This server downloads them and hands them to Claude as real image/text content, so "what's on the school calendar next week?" works even when the calendar itself is empty.


Before you start: how this connects

ParentSquare has no public parent-facing API. Their documented API is district-side, for pushing student data in from an SIS — it is issued to district IT, not to parents, and it is not what you want here. So this server signs in as you and reads the same parent web app you use in a browser.

Two consequences worth knowing up front:

  • You need to supply your own session. See Authentication.

  • The page layouts are not a contract. Districts run different versions of the app on different URLs, so there are three layers of defence: every route is a list of candidate paths tried in order; if all of them fail, the section is located by matching its label in your sidebar; and if a parser still finds nothing, it returns the readable page text rather than failing. scripts/doctor.py reports what needed which. See Fitting it to your district.


Related MCP server: studieplus-mcp

Install

cd "~/Desktop/ParentSquare MCP"
python3 -m venv .venv
./.venv/bin/python -m pip install -e .

Authentication

Works with every district, including ones that sign in through Google, Clever or ClassLink, and with two-factor accounts.

  1. Sign in to ParentSquare in your browser.

  2. Open DevTools → Network, click any request to parentsquare.com.

  3. Under Request Headers, copy the entire value of Cookie:.

  4. Put it in PARENTSQUARE_COOKIE (see Connect it to Claude).

The cookie expires eventually — when tools start reporting that the session expired, repeat this.

Method 2 — email and password

Only works if your district uses a plain ParentSquare password, with no two-factor.

PARENTSQUARE_EMAIL=you@example.com ./.venv/bin/python scripts/login.py

This caches the session in ~/.parentsquare-mcp/session.json (mode 600). If your district uses SSO or 2FA, the script says so and points you back to Method 1.

Connect it to Claude

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "parentsquare": {
      "command": "/Users/chen/Desktop/ParentSquare MCP/.venv/bin/python",
      "args": ["-m", "parentsquare_mcp"],
      "cwd": "/Users/chen/Desktop/ParentSquare MCP",
      "env": {
        "PARENTSQUARE_COOKIE": "_parentsquare_session=…; remember_user_token=…"
      }
    }
  }
}

Restart Claude Desktop.

Claude Code

claude mcp add parentsquare \
  --env PARENTSQUARE_COOKIE="_parentsquare_session=…" \
  -- "/Users/chen/Desktop/ParentSquare MCP/.venv/bin/python" -m parentsquare_mcp

If you used scripts/login.py, the cached session is picked up automatically and you can drop the env block entirely.

See .env.example for every setting.


Fitting it to your district

Run this once after connecting:

./.venv/bin/python scripts/doctor.py

It reports, for every section, which URL works and how many rows the parser got:

— routes —
  ok   feed              /feeds
  ok   directory         /directory
  NAV  payments          /school_pay  (found via the sidebar)
  MISS volunteer_hours   (no candidate worked, and no sidebar link matched)

— tools (23 registered) —
  ok   get_feeds              12 rows
  THIN list_signups           0 rows — selectors need work. Source: https://…/signups
  • NAV — none of the guessed URLs worked, so the server found the section by matching its sidebar label instead. This already works; adding the reported path to routes.py just saves a lookup. Districts re-route these pages constantly, which is why label matching is the safety net.

  • MISS — no URL worked and no sidebar link matched. Open the section in your browser, copy the path from the address bar, and add it to the front of the matching list in parentsquare_mcp/routes.py. If the sidebar calls it something unusual, adding that word to SECTION_KEYWORDS in the same file fixes it for good.

  • THIN — the page loaded but nothing matched. Ask Claude to call debug_fetch on that URL to see the real markup, then adjust the selector list at the top of the relevant file in parentsquare_mcp/tools/. The selectors are plain CSS lists, deliberately easy to edit.

  • empty — the page loaded and genuinely has nothing in it. Nothing to fix.

Nothing in the doctor writes to ParentSquare.


Tools

Feed and posts

Tool

What it does

get_feeds

Paginated feed: titles, authors, dates, summaries, attachment names. Takes a query filter.

get_post

Full post — body, comments, poll results, signup items, and the contents of attached images and PDFs.

get_group_feed

Posts from one group.

Calendar

Tool

What it does

get_calendar_events

Structured events from the ICS feed, recurring events expanded. When empty, explains how to find calendars posted as attachments.

Communication

Tool

What it does

list_conversations / get_conversation

Read message threads.

get_directory

Staff directory: name, role, phone, email, user id.

get_staff_member

Full profile including office hours and profile photo.

Media and files

Tool

What it does

list_photos

Photo gallery with image URLs.

list_files

Shared documents with download URLs.

download_file

Save any attachment to disk.

Things to act on

Tool

What it does

list_signups

Sign-ups and RSVPs with progress (e.g. 53/103 Items).

list_notices

Alerts and secure documents.

list_polls

Polls with vote counts and the leading option.

list_forms

Permission slips, with an outstanding count.

list_payments

Payment items with prices and totals.

list_volunteer_hours

Logged hours with the total.

Discovery

Tool

What it does

list_schools

Schools and students, with the ids other tools take.

list_school_features

Which sections a school actually has, from its sidebar.

list_groups

Groups with member counts and membership status.

list_links

Pinned quick links.

get_student_dashboard

A student's school, grade, classes and teachers.

debug_fetch

Escape hatch: fetch any ParentSquare path and see what is really there.

Nothing here writes to ParentSquare — every tool is read-only against your account. On your own disk, download_file saves where you ask it to, and get_post saves image-only PDFs (scans, which have no extractable text) to ~/Downloads/ParentSquare so they are still reachable.

Things to try

What did the school send home this week?

Is there anything I still need to sign or pay for?

The October calendar was posted as a PDF — what days is my kid off?

Who is my son's teacher and what's their email?

Tests

./.venv/bin/python tests/run_all.py

Four suites — parsers, tools over HTTP, a real MCP handshake over stdio, and the authentication paths — all against a fake ParentSquare served on localhost. They never touch the real site, so they are safe to run at any time.

Layout

parentsquare_mcp/
  config.py      environment settings
  client.py      auth, HTTP, route fallback, login-bounce detection
  routes.py      candidate URLs + sidebar keywords       ← edit when doctor says MISS
  parsers.py     shared HTML helpers and the fallback result shape
  media.py       attachments → images / PDF text
  tools/         one module per group of tools           ← edit when doctor says THIN
scripts/
  login.py       cache a session with email + password
  doctor.py      check routes and tools against your account
tests/

Notes

  • Read-only by design. Nothing posts, replies, signs, pays or RSVPs on your behalf.

  • Your credentials stay on your machine: in the client config env block, or in ~/.parentsquare-mcp/session.json at mode 600.

  • Because it depends on the parent web app's HTML, a ParentSquare redesign can break parsing. That is what doctor.py and debug_fetch are for, and why nothing hard-fails when a selector misses.

Available Tools

23 tools
debug_fetchFetch a raw ParentSquare pageA
Read-only

Escape hatch: fetch any ParentSquare path with your session and return its text, or its raw HTML. Use this when another tool reports that nothing matched the expected layout, to work out what the page really looks like — or to reach a section this server has no dedicated tool for.

Inputs: path (required), limit, raw_html. Returns: object

download_fileDownload a fileA

Download any ParentSquare attachment to disk (default /root/Downloads/ParentSquare) and return the path. Use this for things too large to inline, or when you want to keep a copy.

Inputs: url (required), show, filename.

get_calendar_eventsSchool calendar eventsA
Read-only

Structured calendar events (title, start/end, location, description) from the ParentSquare ICS subscription feed, with recurring events expanded over a date range. Falls back to the HTML calendar view, and when the calendar is empty explains how to find calendars posted as image or PDF attachments instead.

Inputs: query, days_back, days_ahead. Returns: object

get_conversationRead a message threadA
Read-only

Every message in one thread, in order, with senders, timestamps and any attachments.

Inputs: conversation_id (required), include_attachments.

get_directoryStaff directoryA
Read-only

School staff directory as structured rows: name, role/title, phone, email and user id.

Inputs: query, school_id. Returns: object

get_feedsBrowse the school feedA
Read-only

Browse the paginated ParentSquare feed: post titles, authors, dates, summaries, attachment names and links. Use this to find something, then get_post for the full text and attachments.

Inputs: page, query, school_id. Returns: object

get_group_feedPosts from one groupA
Read-only

Posts belonging to a specific ParentSquare group (see list_groups for ids).

Inputs: group_id (required), page. Returns: object

get_postRead a full postA
Read-only

Full details for one post: body text, comments, poll results, signup items, and — when include_attachments is on — the contents of attached images and PDFs, so calendars and flyers can be read directly.

Inputs: post_id (required), include_attachments.

get_staff_memberStaff member detailsA
Read-only

Full profile for one staff member — email, phone, role, office hours — including their profile photo inline.

Inputs: user_id (required), include_photo.

get_student_dashboardStudent dashboardB
Read-only

A student's school, grade, classes and teachers.

Inputs: student_id. Returns: object

list_conversationsList message threadsA
Read-only

Direct-message threads: who they are with, subject, last-message preview and unread state.

Inputs: page. Returns: object

list_filesList filesA
Read-only

Documents the school has shared — handbooks, menus, forms, newsletters — with download URLs.

Inputs: query, school_id. Returns: object

list_formsList formsA
Read-only

Permission slips and signable forms, with whether each one is still outstanding.

Inputs: no named parameters. Returns: object

list_groupsList groupsA
Read-only

ParentSquare groups — classes, clubs, committees — with member counts and whether you are a member.

Inputs: query, school_id. Returns: object

list_noticesList noticesA
Read-only

Alerts, urgent notices and secure documents sent to your account.

Inputs: no named parameters. Returns: object

list_paymentsList paymentsA
Read-only

Payment items and fees with prices, plus totals for what is due and what is paid.

Inputs: no named parameters. Returns: object

list_photosList photosA
Read-only

Photos and photo albums shared by the school, with direct image URLs. Pass a URL to get_post's attachments or download_file to save one.

Inputs: page, school_id. Returns: object

list_pollsList pollsA
Read-only

Polls with their options, vote counts and the option currently in the lead.

Inputs: no named parameters. Returns: object

list_school_featuresSections available for a schoolA
Read-only

Which ParentSquare sections a school actually has — parsed from its sidebar — so you know whether to bother with polls, payments, volunteer hours and so on.

Inputs: school_id. Returns: object

list_schoolsList schools and studentsA
Read-only

The schools and students attached to your account, with their ids. Most other tools accept a school_id — start here to get one.

Inputs: no named parameters. Returns: object

list_signupsList signups and RSVPsA
Read-only

Open sign-ups, RSVPs and volunteer slots, with progress like "53/103 Items" so you can see what still needs filling.

Inputs: no named parameters. Returns: object

list_volunteer_hoursList volunteer hoursA
Read-only

Volunteer hours logged on your account, with the total.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 23 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: feeds, posts, notices, polls, forms, payments, volunteer hours, schools, groups, calendar, conversations, directory, photos, files, and signups. Even similar tools like get_feeds, get_group_feed, and get_post are clearly separated by list vs. single and group filtering, leaving no ambiguity.

    Naming Consistency4/5

    The naming follows a strong list_<resource> / get_<resource> pattern with consistent snake_case. Exceptions like download_file and debug_fetch are action-oriented but still use the verb_noun convention. Minor inconsistency: get_calendar_events returns a list despite using 'get', but overall patterns are predictable.

    Tool Count4/5

    23 tools is on the higher side, but each maps to a distinct ParentSquare data type or action, and none seem redundant. The count feels justified given the broad scope of features covered, from feeds and forms to directory and file downloads. It is slightly heavy but well-scoped.

    Completeness4/5

    The set covers the major read/query surfaces of ParentSquare comprehensively, including posts, groups, events, conversations, directory, media, and documents. The inclusion of download_file and debug_fetch fills gaps for attachments and unknown layout issues. Missing write operations (e.g., creating posts or signing up) suggest an intentional read-only focus, so the surface is quite complete for that purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers