psquare — Claude Code MCP server: what it does, how to install
psquare lets an agent read ParentSquare feeds, calendars, messages, and roster data. It relies on saved session cookies rather than a public API.
claude mcp add psquare -- uvx parentsquare-mcpWhat psquare does
psquare exposes ParentSquare through MCP. The server can read school feeds and post details, calendar events, conversations, staff directories, files, photos, forms, polls, payments, groups, classes, and student dashboards. Attachments can be saved locally, while images and PDFs embedded in posts are returned as part of the post data.
Admin tools cover student and guardian rosters, classes, and staff. Creating or editing records, linking guardians, and sending invitations are disabled until PS_ENABLE_WRITES is set. Every write attempt is recorded in a local audit log, and the server does not delete records.
ParentSquare has no public API here, so psquare relies on saved session cookies and undocumented /api/v2/ JSON endpoints behind the web interface. Those endpoints can change or be blocked, and their use may conflict with ParentSquare terms. Without a valid saved session, the server cannot reach the account data.
What it helps with
- read school feed posts and their details
- turn calendar events into structured data
- look up conversations, staff, or groups
- download a ParentSquare attachment locally
- inspect student and guardian rosters
Example prompts for the agent
- Show the latest ParentSquare school posts and summarize their contents.
- Find this week’s ParentSquare calendar events and include their locations.
- List students without linked guardians so I can review the roster.
How to install psquare
Platform CLI
claude mcp add psquare -- uvx parentsquare-mcpuvx runs the command named after the package; if the README names another one, use uvx --from parentsquare-mcp <command>
Platform CLI
codex mcp add psquare -- uvx parentsquare-mcpuvx runs the command named after the package; if the README names another one, use uvx --from parentsquare-mcp <command>
Config file
{
"mcpServers": {
"psquare": {
"command": "uvx",
"args": [
"parentsquare-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from parentsquare-mcp <command>
Config file
{
"servers": {
"psquare": {
"type": "stdio",
"command": "uvx",
"args": [
"parentsquare-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from parentsquare-mcp <command>
Platform CLI
gemini mcp add psquare uvx parentsquare-mcpuvx runs the command named after the package; if the README names another one, use uvx --from parentsquare-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about psquare
How do I install psquare in Claude Code?
Run claude mcp add psquare -- uvx parentsquare-mcp.
What does psquare do?
It gives an agent MCP tools for ParentSquare feeds, calendars, messages, directories, files, forms, and roster data. Some admin actions can create or edit records after PS_ENABLE_WRITES is enabled.
What is required for admin write tools?
psquare uses saved ParentSquare session cookies. Set PS_ENABLE_WRITES to enable writes; each write attempt is saved in a local audit log.
