CLI & Terminal

Use Foldr with Gemini CLI (MCP)

Gemini CLI is Google's official open-source command-line agent for the Gemini models, with a 1M-token default context and native tool-calling. Gemini CLI reads MCP servers from a `settings.json` file and exposes them as tools to the agent. Foldr gives the CLI a real upload primitive instead of relying on shell scripts.

GooglemacOS, Linux, WindowsMCP: stable

Installation

Add the Foldr MCP server to Gemini CLI with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.

{
  "mcpServers": {
    "foldr": {
      "command": "npx",
      "args": ["-y", "@foldr/mcp-server"],
      "env": { "FOLDR_API_KEY": "fs_live_..." }
    }
  }
}

Setup tip: Edit ~/.gemini/settings.json and restart the CLI with `gemini`.

Official Gemini CLI MCP docs

What You Can Do

Upload any file from Gemini CLI to Foldr and get a shareable URL back in the same turn
Shorten long URLs to foldr.space/s/... links without leaving Gemini CLI
Create or update a Foldr bio page from a Gemini CLI conversation
Generate a hosted Foldr form and paste the submission URL into your reply
Hand off build artifacts, screenshots, and logs to a URL without leaving your editor

Gemini CLI + Foldr FAQ

How do I install the Foldr MCP server in Gemini CLI?

Open Gemini CLI's MCP configuration (the JSON settings file) and paste the config block shown above. Set FOLDR_API_KEY to a key you create at foldr.space/api-keys. Restart Gemini CLI if it doesn't hot-reload.

Which Foldr plan do I need to use the MCP integration with Gemini CLI?

The Foldr MCP server is available on every paid plan (Pro from $5/mo and Developer tier for API-heavy usage). The free tier can generate temporary 7-day links; for permanent storage, a Pro plan or Foldr Space is required.

I set the key but Gemini CLI says the Foldr tool isn't available — what's wrong?

The two most common issues: (1) Gemini CLI wasn't restarted after editing the config — most MCP hosts need a restart to pick up new servers. (2) Your API key is missing the `mcp:invoke` scope. Regenerate a key at foldr.space/api-keys with full scope and retry.

Can Gemini CLI upload files directly to Foldr, or just generate URLs?

Gemini CLI can do both. The MCP server exposes tools for `upload_file` (takes a local path or base64 blob), `shorten_url`, and `create_bio_page`. Any file Gemini CLI can read from disk can be uploaded.

Is the Foldr MCP integration with Gemini CLI production-ready?

Foldr's MCP server is stable and used in production. Gemini CLI's MCP support is currently stable and generally available. We pin to stable SDK versions and publish changelog entries for every breaking change.

Related MCP Integrations

Foldr + Claude Code

CLI & Terminal

Foldr + OpenAI Codex CLI

CLI & Terminal

Foldr + llm (Simon Willison)

CLI & Terminal

Foldr + Claude Desktop

Desktop IDEs & AI Apps

Foldr + Cursor

Desktop IDEs & AI Apps

Browse all MCP integrations

Connect Gemini CLI to Foldr in under a minute

Grab an API key, paste the snippet above into Gemini CLI's MCP config, and your agent can upload files and share URLs immediately.

Get your Foldr API key