ParentSquare MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ParentSquare MCP What's on the school calendar for next week?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.pyreports 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
Method 1 — browser cookie (recommended)
Works with every district, including ones that sign in through Google, Clever or ClassLink, and with two-factor accounts.
Sign in to ParentSquare in your browser.
Open DevTools → Network, click any request to
parentsquare.com.Under Request Headers, copy the entire value of
Cookie:.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.pyThis 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_mcpIf 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.pyIt 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://…/signupsNAV — 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.pyjust 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 toSECTION_KEYWORDSin the same file fixes it for good.THIN — the page loaded but nothing matched. Ask Claude to call
debug_fetchon that URL to see the real markup, then adjust the selector list at the top of the relevant file inparentsquare_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 |
| Paginated feed: titles, authors, dates, summaries, attachment names. Takes a |
| Full post — body, comments, poll results, signup items, and the contents of attached images and PDFs. |
| Posts from one group. |
Calendar
Tool | What it does |
| Structured events from the ICS feed, recurring events expanded. When empty, explains how to find calendars posted as attachments. |
Communication
Tool | What it does |
| Read message threads. |
| Staff directory: name, role, phone, email, user id. |
| Full profile including office hours and profile photo. |
Media and files
Tool | What it does |
| Photo gallery with image URLs. |
| Shared documents with download URLs. |
| Save any attachment to disk. |
Things to act on
Tool | What it does |
| Sign-ups and RSVPs with progress (e.g. |
| Alerts and secure documents. |
| Polls with vote counts and the leading option. |
| Permission slips, with an outstanding count. |
| Payment items with prices and totals. |
| Logged hours with the total. |
Discovery
Tool | What it does |
| Schools and students, with the ids other tools take. |
| Which sections a school actually has, from its sidebar. |
| Groups with member counts and membership status. |
| Pinned quick links. |
| A student's school, grade, classes and teachers. |
| 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.pyFour 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.jsonat mode 600.Because it depends on the parent web app's HTML, a ParentSquare redesign can break parsing. That is what
doctor.pyanddebug_fetchare for, and why nothing hard-fails when a selector misses.
Available Tools
23 toolsdebug_fetchFetch a raw ParentSquare pageARead-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 eventsARead-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 threadARead-only
Every message in one thread, in order, with senders, timestamps and any attachments.
Inputs: conversation_id (required), include_attachments.
get_directoryStaff directoryARead-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 feedARead-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 groupARead-only
Posts belonging to a specific ParentSquare group (see list_groups for ids).
Inputs: group_id (required), page. Returns: object
get_postRead a full postARead-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 detailsARead-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 dashboardBRead-only
A student's school, grade, classes and teachers.
Inputs: student_id. Returns: object
list_conversationsList message threadsARead-only
Direct-message threads: who they are with, subject, last-message preview and unread state.
Inputs: page. Returns: object
list_filesList filesARead-only
Documents the school has shared — handbooks, menus, forms, newsletters — with download URLs.
Inputs: query, school_id. Returns: object
list_formsList formsARead-only
Permission slips and signable forms, with whether each one is still outstanding.
Inputs: no named parameters. Returns: object
list_groupsList groupsARead-only
ParentSquare groups — classes, clubs, committees — with member counts and whether you are a member.
Inputs: query, school_id. Returns: object
list_linksList quick linksARead-only
Quick-access links the school has pinned — Google Drive folders, lunch menus, external sites.
Inputs: school_id. Returns: object
list_noticesList noticesARead-only
Alerts, urgent notices and secure documents sent to your account.
Inputs: no named parameters. Returns: object
list_paymentsList paymentsARead-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 photosARead-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 pollsARead-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 schoolARead-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 studentsARead-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 RSVPsARead-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 hoursARead-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
Scored across 23 tools
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.
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.
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.
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
Related MCP Connectors
Atendio is a WhatsApp AI assistant for businesses in Latin America, on the official WhatsApp Business Platform. This MCP server lets Claude (or any MCP client) list and read WhatsApp conversations, view analytics and assistant settings, and create, edit or delete the rules your AI assistant follows. Remote, OAuth 2.1; the business always reviews and publishes rule changes.
Free WhatsApp MCP server for ChatGPT and Claude: read and search chats, every send you approve.
Official Microsoft MCP Server to query Microsoft Entra data using natural language
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables Claude to access ParentSquare school-parent communication platform, including feeds, calendar, conversations, and media files.48129 PyPI15MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that gives Claude Desktop access to school data from Studie+ (Danish school platform), enabling queries about schedules, homework, assignments, and files directly in chat.MIT
- AlicenseAqualityCmaintenanceMCP server that connects Claude to Edupage, a school information system used across Europe. Provides access to timetables, grades, homework, messages, students, teachers, and more.251GPL 3.0
- AlicenseAqualityDmaintenanceA local MCP server for reading ParentSquare data (feeds, calendar, messages, directory, groups, and more) using undocumented internal APIs. It enables Claude, Cursor, and other MCP clients to access your ParentSquare account via stdio.232MIT