Edular MCP

Connect your AI assistant to Edular

A Model Context Protocol server that lets AI assistants work with your Edular calendar, availability, and academics — on your behalf, with your permission.

1. Your server URL

Edular MCP is per‑school. Your URL includes your school's slug:

https://mcp.edular.app/mcp/<your-slug>

For example, the demo school is:

https://mcp.edular.app/mcp/demo
Finding your slug. It's your school's Edular identifier — the same slug in your Edular portal address. If you're not sure, ask your Edular administrator. Every example below uses demo; replace it with your own.

2. How sign-in works

There's no API key or token to paste. Edular MCP uses OAuth 2.1:

  1. Your client connects and is sent to your school's sign-in page.
  2. You sign in and see a consent screen listing exactly what the assistant may do (see your calendar, create / change events, delete events).
  3. You click Allow, and your client is granted a short-lived, scoped token.

You can revoke access at any time. The assistant only ever acts as you, within what you approved.

3. Connect from your client

OpenAI Codex

Add a custom MCP server:

  1. Type: Streamable HTTP
  2. URL: https://mcp.edular.app/mcp/demo
  3. Leave Bearer token and Headers empty — sign-in is handled by the browser consent flow, not a static token.
  4. Save. Codex opens the consent screen; click Allow.

Claude Code

claude mcp add --transport http edular https://mcp.edular.app/mcp/demo

Then run /mcp in Claude Code and authenticate when prompted.

Claude Desktop & ChatGPT

Add a custom connector in your app's settings and paste the URL https://mcp.edular.app/mcp/demo. The app walks you through the browser sign-in.

Any other client (stdio bridge)

For a client that only speaks stdio, bridge to the remote server with mcp-remote:

npx -y mcp-remote https://mcp.edular.app/mcp/demo

It handles discovery, registration, and the browser sign-in for you.

4. What you can do

Once connected, these tools are available:

Calendar
list-calendarslist-eventsget-eventcreate-eventupdate-eventdelete-event
Attendees & availability
query-availabilityfind-userslist-attendeesadd-attendeesremove-attendeesupdate-rsvp
Your profile
get-me
Your academics
get-my-academicsget-my-gradesget-my-coursesget-my-degree-auditget-my-attendanceget-my-tasks

5. Troubleshooting

My client connected but never asked me to sign in

Make sure you added it as a Streamable HTTP / remote server (or via mcp-remote) — not a plain stdio command. The sign-in prompt appears on connect.

I want to sign in again / switch accounts

Remove and re-add the connector in your client. If you used mcp-remote, clear its cached tokens: rm -rf ~/.mcp-auth.

Wrong school's data

Check the slug in your URL — /mcp/<slug> selects the school.