gemini-extension

This MCP server exposes the Conversion Tools as a Gemini CLI extension. After installing the Gemini extension, you can invoke the Conversion Tools capabilities directly from the Gemini CLI by referencing the extension-enabled commands. The extension adds commands to list available converters, find the best converter for a given input/output format, fetch detailed info about a converter, and perform actual conversions, including support for large file uploads via an upload URL feature. Typical workflows involve asking Gemini to convert a source document from one format to another (for example JSON to Excel, XML to CSV, or PDFs to Word) and letting the extension route the request to the Conversion Tools service for processing.

Key capabilities you’ll use include: converting between 140+ formats, listing converters by category, discovering the best converter for a given pair of formats, authenticating via OAuth, and obtaining an upload URL for large files. Authentication is handled on first use, usually via a browser-based OAuth flow, and you can monitor your usage with the auth_status command. The extension handles the orchestration, while the Conversion Tools backend performs the actual conversions and returns the results back to Gemini.

Prerequisites:

• Gemini CLI installed on your system
• Network access to fetch the extension from GitHub

Step-by-step:

1. Install the Gemini extension for Conversion Tools:

   gemini extensions install https://github.com/conversiontools/gemini-extension

2. Verify installation by listing available extensions or invoking a help command:

   gemini extensions list gemini extensions info conversiontools/gemini-extension

3. (Optional) Configure environment variables if your setup requires an API key or custom config:

   export GEMINI_API_KEY=your_api_key_here export GEMINI_EXTENSION_CONFIG=/path/to/extension/config.json

4. Run the extension-enabled commands through Gemini to perform conversions as needed.

Notes and tips:

• The extension supports a wide range of formats (documents, data, images, PDFs, audio/video, e-books) and OCR capabilities. Use list_converters to get a sense of available formats and supported conversions.
• First use will prompt OAuth authentication in your browser. After authentication, subsequent conversions should proceed without re-authentication.
• For large files, use request_upload_url to obtain an upload URL prior to sending the file, then complete the conversion once uploaded.
• If you encounter rate limits or plan restrictions, check your Conversion Tools account plan at the pricing page and consider upgrading if needed.
• Ensure network access to the Conversion Tools backend and the Gemini extension URL for seamless operation.