Rivian

Read-only MCP server and CLI for Rivian's undocumented GraphQL API. Check your vehicle's battery, range, OTA updates, charging status, and more — right from Claude or your terminal.

Strictly read-only — no vehicle commands, no settings changes.

Install as Claude Code Plugin

Install the skill so Claude automatically knows how to work with this codebase and the Rivian API — confirmed vehicle state properties, auth flow, formatter patterns, and what fields don't exist.

From the terminal:

claude /plugin marketplace add PatrickHeneise/rivian-mcp
claude /plugin install rivian-mcp@rivian-ai
claude /plugin install rivian-mcp@rivian-ai

Inside Claude Code, type:

/plugin marketplace add PatrickHeneise/rivian-mcp

Then:

/plugin install rivian-mcp@rivian-ai
/plugin install rivian-mcp@rivian-ai

Setup

claude mcp add rivian \
  -e [email protected] \
  -e RIVIAN_PASSWORD=your-password \
  -- npx rivian-mcp

{
  "mcpServers": {
    "rivian": {
      "command": "npx",
      "args": ["rivian-mcp"],
      "env": {
        "RIVIAN_EMAIL": "[email protected]",
        "RIVIAN_PASSWORD": "your-password"
      }
    }
  }
}

First-time login

Rivian requires 2FA on every new login:

1. Ask Claude: "Log in to Rivian"
2. Rivian sends a verification code to your phone/email
3. Tell Claude the code: "The code is 123456"

Your session is saved to ~/.rivian-mcp/session.json and reused automatically until it expires (7 days).

What you can ask

• "What's my battery level?"
• "Is there a software update available?"
• "Are all the doors locked?"
• "Show me the full vehicle status"
• "Who has keys to my R1S?"
• "Am I currently charging?"
• "Show my charging history"
• "What's my charging schedule?"

Tools

CLI

The package also installs a rivian CLI for quick terminal access without Claude.

npx rivian-mcp ota    # OTA software update status
npx rivian-mcp stats  # Full vehicle state

Or install globally:

npm install -g rivian-mcp
rivian ota
rivian stats

Authentication works the same way — credentials from RIVIAN_EMAIL/RIVIAN_PASSWORD env vars or interactive prompts. Session is shared with the MCP server (~/.rivian-mcp/session.json).

Requirements

• Node.js 24+
• A Rivian account with a vehicle

Support

If you're thinking about getting a Rivian and don't have a referral yet, here's mine — you'll get benefits on your purchase and it helps support this project:

Get a Rivian R1 with referral benefits

References

• Rivian API Docs — community-maintained
• rivian-python-client — Python client this is based on
• home-assistant-rivian — Home Assistant integration