pyhood-mcp

Model Context Protocol (MCP) server for Robinhood trading via pyhood

Connect your Robinhood account to Claude Code (or any MCP client) for conversational portfolio management and automated trading.

Features

• 📊 Portfolio monitoring (positions, gains/losses, buying power)

• 📈 Real-time quotes and market data

• 🔄 Stock order placement (market, limit, stop orders)

• 📜 Order history and management

• 📉 Historical price data for technical analysis

• 💰 Options chain data and expirations

• 🏢 Fundamental data (market cap, PE ratio, etc.)

Installation

Prerequisites

• Python 3.10+

• A Robinhood account

• Claude Code (or any MCP-compatible client)

Install dependencies

pip install pyhood mcp

Download the server

# Clone this repo
git clone https://github.com/YOUR_USERNAME/pyhood-mcp.git
cd pyhood-mcp

# Or just download pyhood_mcp_server.py
curl -O https://raw.githubusercontent.com/YOUR_USERNAME/pyhood-mcp/main/pyhood_mcp_server.py
chmod +x pyhood_mcp_server.py

Setup

1. Authenticate with Robinhood

First, create a session (handles 2FA):

python3 -c "import pyhood; pyhood.login(username='YOUR_EMAIL', password='YOUR_PASSWORD')"

This creates a cached session in ~/.pyhood/session.json.

2. Configure Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "pyhood": {
      "command": "python3",
      "args": ["/path/to/pyhood_mcp_server.py"],
      "env": {
        "ROBINHOOD_USERNAME": "your_email@example.com",
        "ROBINHOOD_PASSWORD": "your_password"
      }
    }
  }
}

Or set environment variables in your shell:

export ROBINHOOD_USERNAME="your_email@example.com"
export ROBINHOOD_PASSWORD="your_password"

3. Restart Claude Code

The pyhood MCP server will now be available in Claude Code.

Usage

In Claude Code

What's my portfolio performance today?

Get a quote for NVDA

Place a market order to buy 10 shares of AAPL

Show me my recent order history

Get historical data for TSLA over the past month

Available Tools

Security

⚠️ Important Security Notes:

• Never commit your Robinhood credentials to git

• The session cache (~/.pyhood/session.json) contains sensitive tokens

• Use environment variables for credentials when possible

• This server runs locally and communicates only with Robinhood's API

Pattern Day Trading (PDT)

If your account is <$25k, you're limited to 3 day trades per rolling 5-day period. Be careful with automated trading strategies. See FINRA PDT rules.

Dependencies

• pyhood - Modern Robinhood Python client

• mcp - Model Context Protocol SDK

Disclaimer

This software is for educational purposes only. Trading stocks involves risk.

• You are responsible for all trades executed through this tool

• No warranty or guarantee of fitness for any purpose

• The authors are not liable for any financial losses

• Always verify orders before execution

• Use at your own risk

Robinhood® is a trademark of Robinhood Markets, Inc. This project is not affiliated with or endorsed by Robinhood.

Contributing

Contributions welcome! Please:

1. Fork the repo

2. Create a feature branch

3. Submit a pull request

License

MIT License - see LICENSE file for details

Related Projects

• autonomous-trading-agent - Autonomous trading agent using this MCP server

• pyhood - The underlying Robinhood API client

Support

• Issues: GitHub Issues

• Discussions: GitHub Discussions