musemen/resy-mcp-server

✨ Features

🚀 Installation

Prerequisites

• Python 3.10 or higher
• pip or poetry
• A Resy account with valid authentication tokens

Quick Install

# Clone the repository
git clone https://github.com/musemen/resy-mcp-server.git
cd resy-mcp-server

# Run the automated setup
chmod +x setup.sh
./setup.sh

Manual Installation

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install additional required package
pip install greenlet

🏃 Quick Start

1. Get Your Resy Authentication Token

2. Configure MCP Client

Add to your Claude Desktop or other MCP client configuration:

{
  "mcpServers": {
    "resy": {
      "command": "python",
      "args": ["-m", "src"],
      "cwd": "/path/to/resy-mcp-server",
      "env": {
        "PYTHONPATH": "/path/to/resy-mcp-server"
      }
    }
  }
}

3. Add Your Account

User: Add my Resy account named "Personal" with token "eyJ0eX..."
Assistant: ✅ Account added successfully!

📖 Usage

🔍 Restaurant Search

Basic Search

Find Italian restaurants in Manhattan for tomorrow at 7pm for 2 people

Advanced Search

Search for romantic restaurants in West Village for Saturday at 8pm, 
party of 4, price range $$-$$$, with outdoor seating

📅 Reservation Management

Book a Reservation

Book the second restaurant from the search results

View Reservations

Show my upcoming reservations

Cancel Reservation

Cancel reservation [ID] because "Plans changed"

🎯 Automated Booking (Sniping)

Perfect for securing tables at popular restaurants that release reservations at specific times:

Schedule a booking for Carbone on August 15th at 7:00 PM for 4 people.
Book it 14 days in advance at 9:00 AM sharp.
Try these times in order: 7:00 PM, 7:30 PM, 8:00 PM

📋 Waitlist Management

# Join waitlist
Join the waitlist at Osteria Cotta for 4 people

# Check status
Check my waitlist status in Manhattan

# Leave waitlist
Leave waitlist [ID]

🗓️ Calendar Export

# Export all reservations
Export my reservations to calendar

# Get calendar links
Get calendar links for reservation [ID]

📚 API Reference

🔧 Advanced Configuration

Environment Variables

Create a .env file in the project root:

# Logging level (DEBUG, INFO, WARNING, ERROR)
RESY_MCP_LOG_LEVEL=INFO

# Dry run mode - logs API calls without making them
RESY_MCP_DRY_RUN=false

# Custom config directory
RESY_MCP_CONFIG_PATH=~/.resy-mcp

NYC Neighborhood Support

Pre-configured coordinates for popular NYC areas:

• Manhattan, Brooklyn, Queens, Bronx, Staten Island
• East Village, West Village, Chelsea, SoHo, TriBeCa
• Upper East Side, Upper West Side, Midtown
• Williamsburg, DUMBO

Database Structure

All data is stored securely in ~/.resy-mcp/:

~/.resy-mcp/
├── tokens.enc          # Encrypted auth tokens
├── resy.db            # SQLite database
└── .key               # Encryption key

🛡️ Security

• Encryption: All tokens encrypted with Fernet symmetric encryption
• Permissions: Files created with 600 permissions (owner only)
• No Logging: Tokens never appear in logs or error messages
• Isolation: Each account's data is fully isolated

🐛 Troubleshooting

🏗️ Architecture

resy-mcp-server/
├── src/
│   ├── server.py          # MCP server entry point
│   ├── services/          # Business logic layer
│   │   ├── auth.py        # Authentication management
│   │   ├── search.py      # Restaurant search
│   │   ├── booking.py     # Reservation operations
│   │   ├── scheduler.py   # Automated scheduling
│   │   ├── waitlist.py    # Waitlist management
│   │   └── calendar.py    # Calendar integration
│   ├── utils/             # Utility modules
│   │   ├── crypto.py      # Encryption utilities
│   │   ├── database.py    # Database models
│   │   └── resy_api.py    # API client
│   └── models/            # Data models
│       └── types.py       # Type definitions
├── tests/                 # Test suite
├── setup.sh              # Quick setup script
├── requirements.txt      # Python dependencies
└── README.md            # You are here! 

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the file for details.

🙏 Acknowledgments

• Built for the Model Context Protocol
• Inspired by the Resy community's booking automation needs
• Uses the Resy API (unofficial)

⚠️ Disclaimer

This tool is for personal use only. Please respect Resy's terms of service and use responsibly. The authors are not responsible for any misuse or violations of Resy's policies.