Back to Browse

Gpa Calculator MCP Server

Developer ToolsModerate6.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

GPA, grade conversion and what-do-I-need-on-the-final math for AI. Works offline, no account.

About

GPA, grade conversion and what-do-I-need-on-the-final math for AI. Works offline, no account.

Security Report

6.3
Moderate6.3Moderate Risk

This is a self-contained GPA and grade calculator with no network calls, no credentials, and no filesystem or shell access, so its permissions match its purpose. The code is clean and well tested, with only informational code-quality notes such as an inaccurate openWorldHint annotation and some unused helper code. Supply chain analysis found 3 known vulnerabilities in dependencies (2 critical, 0 high severity). Package verification found 1 issue.

7 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-anonymousonyx22-gpa-calculator-mcp": {
      "args": [
        "-y",
        "gpa-calculator-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

GPA Calculator MCP

npm downloads license

Ask your AI to work out your GPA, convert grades between letters and percentages, and figure out what you need on the final. The math is done by tested code, not guessed by the model.

This is a free, open source MCP server. It works with Claude, ChatGPT, Cursor, VS Code Copilot and any other app that supports MCP. It runs on your computer, needs no internet and no login, and never sees your school account.

Free forever. No account and no subscription.

Quick start

Add this to your AI app's MCP config. For Claude Desktop that is claude_desktop_config.json.

{
  "mcpServers": {
    "gpa": {
      "command": "npx",
      "args": ["-y", "gpa-calculator-mcp"]
    }
  }
}

Restart your AI app, then try one of the questions below. You need Node.js 20 or newer.

For Claude Code, run claude mcp add gpa -- npx -y gpa-calculator-mcp.

What you can ask

  • "What's my GPA if I got an A in 3 credits, a B+ in 4 credits and a C in 3 credits?"
  • "What do I need on the final to get an 80 if it's worth 40% and I'm at 74 right now?"
  • "Convert 78 percent to a letter grade on the Ontario college scale."
  • "I have a 3.1 GPA over 60 credits. What GPA do I need next semester to reach 3.4?"
  • "My course is 20% quizzes, 30% labs, 50% exam. I have 85 on quizzes and 70 on labs. What's my grade so far and what's the best I can finish with?"

Tools

ToolWhat it does
calculate_gpaGPA for a list of courses with credits and grades, optionally combined with your earlier GPA
convert_gradeConvert a letter or percentage to the matching letter, percentage range and grade points
needed_on_finalThe score you need on the final to hit a target, and whether it is possible
weighted_gradeYour grade so far and your best and worst possible finish from weighted parts
target_gpa_plannerThe GPA you need on upcoming credits to reach a target cumulative GPA
list_scalesThe grade scales built in, with their letter, percentage and points tables

Grade scales

Scale idDescription
us4Common US 4.0 scale with plus and minus grades, A is 4.0 and A- is 3.7
us4plusSame as us4 but A+ is 4.3
ontario-collegeA common Ontario college 4.0 scale, A+ and A are 4.0, B+ is 3.5. Check your own school's table

Schools differ. Run list_scales to see the exact table used, and tell your AI if your school's cutoffs are different.

Development

npm install
npm run build
npm test

The tests call every tool through a real MCP client, so they need no account or network.

More free student MCP servers

All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.

ServerWhat it does
Brightspace MCPD2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files.
Canvas MCPRead-only Canvas LMS for AI. Due dates, missing work, grades and announcements.
Moodle MCPRead-only Moodle for AI. Due dates, overdue work, grades and announcements.
Google Classroom MCPRead-only Google Classroom for AI. To-do, due dates, missing work and grades.
Citations MCPAPA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account.
Study Planner MCPExam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline.
Paper Finder MCPSearch scholarly papers, find open access copies and related work through OpenAlex. No key needed.

License

MIT

Reviews

No reviews yet

Be the first to review this server!