Conversion Tools - Gemini CLI Extension

Conversion Tools extension for Gemini CLI. Convert 140+ file formats directly in your terminal - no browser tabs, no copy-pasting. Or build a custom converter from a plain-language description when no standard one fits.

Part of the Conversion Tools agent integrations (Claude Code, Cursor, Codex, Grok, Gemini, plus the ctio CLI).

Install

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

Update

Pull the latest version (recommended periodically - new converters and fixes ship regularly):

gemini extensions update conversiontools

Or update every installed extension:

gemini extensions update --all

Usage

Once installed, just ask Gemini to convert files:

Convert data.json to Excel

Transform this XML file to CSV

Convert report.pdf to a Word document

Available Tools

| Tool | Description | |------|-------------| | convert_file | Convert a file from one format to another | | list_converters | List available converters by category | | find_converter | Find the best converter for specific formats | | get_converter_info | Get detailed info about a converter | | request_upload_url | Get upload URL for large files (over 5MB) | | auth_status | Check authentication status | | auth_login | Login via OAuth | | auth_logout | Logout and clear credentials | | studio_create_converter | Build a custom converter: create it + attach the input file | | studio_chat | Describe the transformation in plain language; the converter is built | | studio_run | Run the built converter on the file | | studio_run_status | Poll the run until it finishes | | studio_download_result | Download the result | | studio_list_converters | List your previously built converters (to reuse one instead of rebuilding) | | studio_get_converter | Inspect a converter's details and check it's ready to run | | studio_attach_file | Attach a new file to an existing converter and re-run its built logic |

Supported Conversions

140+ conversion types including:

• Documents: Word, PowerPoint, Excel, Markdown, ODS to/from PDF, HTML, Text, LaTeX
• Data: JSON, CSV, XML, YAML, Parquet, JSONL, BSON, Excel - with validators and formatters
• Images: PNG, JPG, WebP, AVIF, HEIC, JXL (JPEG XL), SVG, BMP, TIFF, GIF
• PDF: Extract to Word, Excel, CSV, Text, HTML, Images (JPG, PNG, SVG, TIFF), EPUB
• Audio: MP3, WAV, FLAC - plus AI text-to-speech and speech-to-text
• Video: MP4, MOV, MKV, AVI - plus audio extraction
• E-books: EPUB, MOBI, AZW, AZW3, FB2, FBZ, PDF
• OCR: Extract text from images and scanned PDFs - output as Text or searchable PDF
• AI-powered: Smart extraction from complex documents, subtitle translation, TTS, STT
• Subtitles: SRT, VTT, ASS - bidirectional conversions
• Web: Website screenshots (URL to PDF, JPG, PNG)
• Custom (AI Studio): describe a transformation in plain language and have a reusable converter built, run, and returned - for when no standard converter fits

Authentication

On first use, you will be prompted to authenticate via OAuth. This opens a browser window to log in to your Conversion Tools account.

Free accounts get 100 conversions per month (10 per day). Paid plans available at conversiontools.io/pricing.

Examples

Convert JSON to Excel

I have a data.json file with an array of objects. Convert it to Excel.

Extract data from PDF

Extract the table from invoice.pdf to CSV

Links

• All agent integrations
• Pricing
• Support

License

MIT