Read Remind classes, chats and messages, and manage notification settings.
About
Read Remind classes, chats and messages, and manage notification settings.
Security Report
Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (103/104 approved).
9 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: REMIND_COOKIE
Environment variable: REMIND_CSRF_TOKEN
Environment variable: REMIND_WS_PORT
Environment variable: REMIND_SESSION_FILE
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-chrischall-remind-mcp": {
"env": {
"REMIND_COOKIE": "your-remind-cookie-here",
"REMIND_WS_PORT": "your-remind-ws-port-here",
"REMIND_CSRF_TOKEN": "your-remind-csrf-token-here"
},
"args": [
"-y",
"@chrischall/remind-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
remind-mcp
MCP server for Remind — read your classes, chats and messages, and manage notification settings.
This project was developed and is maintained by AI. Use at your own discretion.
Remind exposes a single GraphQL endpoint that is reachable server-side, so only the credential needs a browser: the session is lifted once from a signed-in tab through the fetchproxy bridge, and every request after that is a plain server-side fetch.
Install
npx -y @chrischall/remind-mcp
{
"mcpServers": {
"remind": { "command": "npx", "args": ["-y", "@chrischall/remind-mcp"] }
}
}
Authentication
Two headers are captured from a signed-in remind.com tab: the full Cookie header and the
x-csrf-token value. Either let the bridge capture them (needs the Transporter Chrome
extension and a signed-in tab), or supply them yourself:
| Variable | Required | Description |
|---|---|---|
REMIND_COOKIE | no | Captured Cookie request header. Skips the bridge when set with the next one. |
REMIND_CSRF_TOKEN | no | Captured x-csrf-token value. |
REMIND_WS_PORT | no | fetchproxy bridge concentrator port (default 37149). |
REMIND_SESSION_FILE | no | Where the captured session is cached. Defaults to $MCP_DATA_DIR/$HOME under .remind-mcp. |
The server boots without either, so a host's install-time tools/list probe succeeds; the
error surfaces on the first tool call instead.
The browser is needed once. A captured session is cached (mode 0600) and reused across
restarts, and every call after the bootstrap is a plain server-side fetch. This matters because
the capture completes only while the signed-in tab is actually issuing a /graphql request — so
without the cache, a restart would sit waiting unless you happened to be using Remind.
Tools
| Tool | |
|---|---|
remind_me | The signed-in account. |
remind_list_entities | Classes and chats with unread counts — start here, it yields the uuids. |
remind_get_classes | Full class detail by uuid. |
remind_list_chats | Conversation streams and their permissions (canSend). |
remind_get_messages | Messages in a chat stream. |
remind_get_notification_settings | Preferences and delivery devices. |
remind_set_notification_devices | Enable/disable delivery devices. Confirm-gated. |
remind_send_message | Send to a chat or class. Confirm-gated. |
remind_graphql | Arbitrary read-only GraphQL; introspection is enabled. Mutations refused. |
remind_healthcheck | Verify the session still authenticates. |
Write tools take confirm: true. Without it they make no network call and return a dry-run
preview of the exact payload.
Without the server
skills/remind-fpx/ is a shell-only skill covering the same read surface with fpx + curl —
no MCP process required.
Notes
- An expired session returns HTTP 200 with
errors[0].message = "Unauthorized"; the same string also means "your account may not do that" (scheduled messages are owner/teacher-only). - An unknown field reports as
Internal service error, not a field error — introspect rather than guess.docs/REMIND-API.mdis the capture log.
Development
npm install && npm run build && npm test
npm run test:coverage
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption