Skip to content
MCP server

Study Planner MCP

Offline exam study planner with spaced repetition dates, pomodoro blocks and ICS export

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.9
Listing updated
3 days ago

About Study Planner MCP

Study Planner MCP is an open-source MCP server for education and exams. It runs locally on your machine and is started by your AI client.

You supply exam dates and the hours you can study, either the same every day or different per weekday, and the server returns a day-by-day plan. It also works out spaced repetition review dates for a topic, splits a long assignment into dated milestones, and lays out pomodoro blocks with breaks. The README stresses that the date arithmetic is done by tested code rather than guessed by the model.

It reads no school site and needs no login, internet connection or key, and stores nothing; it runs on your own machine through npx and needs Node.js 20 or newer. The README positions it as a companion to LMS servers: those report what is assigned, this one plans how to study it. A plan can be exported as an .ics file for import into Google Calendar.

It is one of several free, open source student servers from the same author, alongside a GPA calculator, citation maker and paper finder.

Install

Run in a terminal

claude mcp add study-planner-mcp -- npx -y study-planner-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "study-planner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "study-planner-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "study-planner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "study-planner-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "study-planner-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "study-planner-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "study-planner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "study-planner-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "study-planner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "study-planner-mcp"
      ]
    }
  }
}

What it does

Exam study schedule
Builds a day-by-day plan from exam dates and available hours, with per-weekday hours supported.
Spaced repetition dates
Calculates when to review a topic before an exam.
Pomodoro planning
Splits study hours into focused blocks with breaks.
Assignment milestones
Breaks a large assignment into dated steps toward its deadline.
Topic hour split
Divides study hours across the topics an exam covers.
ICS export
Produces the plan as an .ics file for calendar import.

Good for

  • Plan three weeks of revision across several exams
  • Decide what to study today
  • Schedule review sessions before an exam date
  • Break a six-hour essay into milestones
  • Move a study plan into Google Calendar

Pricing

Open source

Free and open source

Prices change. Check brightspacemcp.com before you buy.

Study Planner MCP FAQ

Does it need an account or internet?

No. It runs offline on your computer with no account, key or login, and stores nothing.

What do I need to run it?

Node.js 20 or newer; start it with npx -y study-planner-mcp.

Which apps work with it?

Claude Desktop, Claude Code, ChatGPT desktop, Cursor, VS Code Copilot and other MCP clients.

Can I put the plan in my calendar?

Yes, ask for the plan as an .ics file and import it, for example into Google Calendar.

Is Study Planner MCP free?

Yes. Study Planner MCP is open source, so you can use and self-host it for free.

How do I add Study Planner MCP to Claude Code?

Run this command in your terminal: claude mcp add study-planner-mcp -- npx -y study-planner-mcp

What are the best alternatives to Study Planner MCP?

The closest alternatives to Study Planner MCP are Ha MCP, Concord MCP, note1, CalderFlow and Born Then.

Alternatives to Study Planner MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  6. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication