Skip to content
MCP server

grad-agent

Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.2.9
Listing updated
5 days ago

About grad-agent

grad-agent is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Autonomous MCP agent for grad school applications: prof discovery, cold emails, SOP, tracking.

Install

Run in a terminal

claude mcp add grad-agent --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env SMTP_SERVER='<SMTP_SERVER>' --env SMTP_PORT='<SMTP_PORT>' --env SMTP_USERNAME='<SMTP_USERNAME>' --env SMTP_PASSWORD='<SMTP_PASSWORD>' --env SMTP_FROM='<SMTP_FROM>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env HF_TOKEN='<HF_TOKEN>' -- uvx grad-agent

Add to claude_desktop_config.json

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<SMTP_SERVER>",
        "SMTP_PORT": "<SMTP_PORT>",
        "SMTP_USERNAME": "<SMTP_USERNAME>",
        "SMTP_PASSWORD": "<SMTP_PASSWORD>",
        "SMTP_FROM": "<SMTP_FROM>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<SMTP_SERVER>",
        "SMTP_PORT": "<SMTP_PORT>",
        "SMTP_USERNAME": "<SMTP_USERNAME>",
        "SMTP_PASSWORD": "<SMTP_PASSWORD>",
        "SMTP_FROM": "<SMTP_FROM>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "grad-agent": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "grad-agent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<SMTP_SERVER>",
        "SMTP_PORT": "<SMTP_PORT>",
        "SMTP_USERNAME": "<SMTP_USERNAME>",
        "SMTP_PASSWORD": "<SMTP_PASSWORD>",
        "SMTP_FROM": "<SMTP_FROM>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<SMTP_SERVER>",
        "SMTP_PORT": "<SMTP_PORT>",
        "SMTP_USERNAME": "<SMTP_USERNAME>",
        "SMTP_PASSWORD": "<SMTP_PASSWORD>",
        "SMTP_FROM": "<SMTP_FROM>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "grad-agent": {
      "command": "uvx",
      "args": [
        "grad-agent"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "SMTP_SERVER": "<SMTP_SERVER>",
        "SMTP_PORT": "<SMTP_PORT>",
        "SMTP_USERNAME": "<SMTP_USERNAME>",
        "SMTP_PASSWORD": "<SMTP_PASSWORD>",
        "SMTP_FROM": "<SMTP_FROM>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>",
        "HF_TOKEN": "<HF_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ANTHROPIC_API_KEYAnthropic API key used by Claude Haiku for hook synthesis and verification.Required
  • SMTP_SERVERSMTP host for the review mailer.Required
  • SMTP_PORTSMTP port.Required
  • SMTP_USERNAMESMTP username; used as From address by default.Required
  • SMTP_PASSWORDSMTP password. Gmail App Password recommended.Required
  • SMTP_FROMEnvelope From address for drafts emailed to the user's review inbox.Required
  • GITHUB_TOKENOptional. Personal access token used to enumerate the user's public and private GitHub repos during catalog sync.
  • HF_TOKENOptional. HuggingFace token used to enumerate the user's published models and datasets during catalog sync.
  • GRAD_AGENT_HOMEOptional. Override the default ~/.grad-agent/ location for profile, programs, secrets, and data.
  • LOR_LETTERHEAD_PATHOptional. Absolute path to a letterhead / company logo image (.png / .jpg / .pdf) embedded at the top of Letters of Recommendation during LaTeX compile. Leave unset for a plain top block. Can also be set at runtime via the `set_letterhead` MCP tool.
  • LOR_LETTERHEAD_WIDTHOptional. LaTeX length for the letterhead image width (e.g. '2.5in'). Used only when LOR_LETTERHEAD_PATH is set.

Pricing

Open source

grad-agent FAQ

Is grad-agent free?

Yes. grad-agent is open source, so you can use and self-host it for free.

How do I add grad-agent to Claude Code?

Run this command in your terminal: claude mcp add grad-agent --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env SMTP_SERVER='<SMTP_SERVER>' --env SMTP_PORT='<SMTP_PORT>' --env SMTP_USERNAME='<SMTP_USERNAME>' --env SMTP_PASSWORD='<SMTP_PASSWORD>' --env SMTP_FROM='<SMTP_FROM>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env HF_TOKEN='<HF_TOKEN>' -- uvx grad-agent

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers