Gemini CLI
Step-by-step guide to connect Screpy MCP to Gemini CLI with OAuth.
Use this guide to add Screpy as a remote HTTP MCP server in Gemini CLI. The connection is stored at user scope and authorizes through your browser.
Connect Screpy MCP to Gemini CLI
Open a local terminal
Use a terminal on a computer that can open a browser. The first Screpy OAuth connection cannot finish in a headless SSH session or container.
Add the Screpy MCP server
Run:
gemini mcp add --scope user --transport http screpy https://mcp.screpy.comThis adds Screpy to your user-level Gemini CLI configuration. It does not need a Screpy REST API key.
Authorize Screpy
Start Gemini CLI. When it asks to authenticate Screpy, open the browser link, sign in to the correct Screpy account, and approve access.
Verify project access
Ask Gemini:
Use Screpy to list my projects and report the latest completed crawl for each one.
If the server is connected but tools are unavailable
Run /mcp reload in Gemini CLI, then try the project-list prompt again. If authorization cannot open, finish the first connection from a local terminal and review Troubleshooting.