Skip to content

Raindrop + Gemini CLI Quick Start

This content is for the 0.6.3 version. Switch to the latest version for up-to-date documentation.

The Raindrop MCP server transforms Gemini CLI into a powerful infrastructure development platform. Instead of just writing code, you can build complete applications with databases, APIs, and deployment infrastructure through structured, guided workflows.

Step 1: Install Required Tools

Install Gemini CLI

Follow the installation instructions at Gemini CLI GitHub repository.

Install Raindrop CLI

Terminal window
npm install -g @liquidmetal-ai/raindrop

Step 2: Sign Up for Raindrop

Create your Raindrop account:

  1. Sign up for a Raindrop account at liquidmetal.run
  2. Complete the account setup process

Step 3: Authenticate

Run the following command to authenticate the Raindrop CLI:

Terminal window
raindrop auth login

Step 4: Set Up MCP Integration

Run the following command in your terminal to set up the MCP integration:

Terminal window
raindrop mcp install-gemini

What this command does:

  • Configures Gemini CLI with the correct MCP server URL
  • Sets up RAINDROP.md guidelines in ~/.gemini/
  • Creates custom TOML slash commands in ~/.gemini/commands/:
    • /new-raindrop-app
    • /update-raindrop-app
    • /reattach-raindrop-session

Step 5: Start Gemini CLI

  1. Start or restart Gemini CLI for changes to take effect
Terminal window
gemini
  1. Authenticate and connect raindrop-mcp with gemini
Terminal window
/mcp auth raindrop-mcp
  1. Verify the MCP server is available:
Terminal window
/mcp list

Using the Raindrop MCP Server

Once configured, you have access to three main workflows for building applications:

1. Start a New Application

Create a new Raindrop application from scratch:

Using Slash Command:

Terminal window
/new-raindrop-app

Using Direct MCP Call:

Terminal window
Use the raindrop-mcp login tool to start a new application development session.

What Happens:

  • Creates a new session ID and timeline ID
  • Guides you through requirements gathering (PRD creation)
  • Generates application architecture and manifest
  • Sets up databases, services, and infrastructure
  • Implements complete application code
  • Deploys to live infrastructure
  • Validates deployment with endpoint testing