@newtonschool/newton-mcp

Connect your AI assistant to your Newton School account. Ask about your courses, lectures, assignments, practice problems, and more — all read-only.

Setup

1. Add to your AI assistant

Pick your client and copy-paste the config:

Add to your Claude Desktop config:

{
  "mcpServers": {
    "newton": {
      "command": "npx",
      "args": ["-y", "@newtonschool/newton-mcp@latest"]
    }
  }
}

claude mcp add newton -- npx -y @newtonschool/newton-mcp@latest

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "newton": {
      "command": "npx",
      "args": ["-y", "@newtonschool/newton-mcp@latest"]
    }
  }
}

codex mcp add newton -- npx -y @newtonschool/newton-mcp@latest

2. Log in

Run this once in your terminal:

npx -y @newtonschool/newton-mcp@latest login

A browser window will open — enter the code shown in your terminal to connect your Newton School account.

3. Start asking

Restart your AI assistant, then try:

• "How am I doing?" — course overview, XP, rank
• "When is my next class?" — upcoming lectures and contests
• "What did I miss last week?" — recent lectures with recordings
• "Give me some array problems" — search practice questions by topic/difficulty
• "What assignments are due?" — deadlines and submission status
• "My DSA progress" — subject-level completion stats
• "Today's QOTD" — Question of the Day with streak info
• "Leaderboard" — class rankings

Other commands

npx -y @newtonschool/newton-mcp@latest status   # Check auth status
npx -y @newtonschool/newton-mcp@latest logout   # Clear credentials

Troubleshooting

"Authentication required" error in chat? Run the login command above in your terminal, then retry.

Want faster startup? Install globally with npm install -g @newtonschool/newton-mcp, then use newton-mcp directly instead of the npx ... commands.

Requirements

• macOS (Apple Silicon)
• Node.js
• A Newton School student account

Links

• Newton School