Catalog › Plugins › Files & documents › unstructured-transformUT unstructured-transform Parse documents (PDF, DOCX, PPTX, XLSX, HTML, EML, images, and multiple other formats) into markdown, element JSON, HTML, or plain text with
Parse documents (PDF, DOCX, PPTX, XLSX, HTML, EML, images, and multiple other formats) into markdown, element JSON, HTML, or plain text with the Unstructured Transform MCP server.
README Loading documentation…
# Unstructured Transform extension for Gemini CLI
This repository is the [Gemini CLI](https://github.com/google-gemini/gemini-cli)
extension for the [Unstructured Transform](https://transform.unstructured.io)
MCP server (`https://mcp.transform.unstructured.io`). It lets Gemini CLI
parse documents (PDF, DOCX, PPTX, XLSX, HTML, EML, images, and multiple
other formats) into markdown, element JSON, HTML, or plain text.
The [Transform documentation](https://docs.unstructured.io/transform/overview)
is the source of truth for what the server does, its
[supported file types](https://docs.unstructured.io/transform/supported-file-types),
[parsing options](https://docs.unstructured.io/transform/output), request
limits, and billing. This repository only carries the Gemini extension
manifest and the agent guidance the extension ships.
## Install
```sh
gemini extensions install https://github.com/Unstructured-IO/transform-gemini-extension
```
Then sign in once with `/mcp auth transform` (browser OAuth; no API key
needed). The extension registers the `transform` server and ships the
agent guidance in [`AGENTS.md`](https://github.com/unstructured-io/transform-gemini-extension/blob/HEAD/AGENTS.md).
Using another tool (Claude Code, Claude Desktop, Cursor, Codex, Google
Antigravity, Cline)? See the
[official install guides](https://docs.unstructured.io/transform/install/overview)
and the [Unstructured MCP integrations](https://github.com/Unstructured-IO/unstructured-mcp-integrations)
index.
## Using it
Ask Gemini to parse something, for example: *"Parse report.pdf to
markdown."* The agent uploads the file, starts a job, polls until it
finishes, and writes the structured result. Large or scanned files can
take a few minutes. [`AGENTS.md`](https://github.com/unstructured-io/transform-gemini-extension/blob/HEAD/AGENTS.md) carries the guidance agents
follow for this flow.
## Repository structure
```text
├── AGENTS.md # agent guidance, shipped with the extension
├── gemini-extension.json # Gemini CLI extension manifest
├── scripts/validate.sh # consistency checks (plain bash)
├── .github/workflows/
│ └── validate.yml # runs the checks in CI
├── CODEOWNERS
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── .editorconfig
├── .gitattributes
└── .gitignore
```
## Validation
```sh
./scripts/validate.sh
```
Checks that the manifest is valid JSON and that no tracked file
references a server URL other than the one in the manifest. Runs in CI on
pull requests and pushes to `main`.
## Contributing
This repository is maintained by the Unstructured team. Bug reports and
suggestions are welcome as issues. See [CONTRIBUTING.md](https://github.com/unstructured-io/transform-gemini-extension/blob/HEAD/CONTRIBUTING.md)
before opening a pull request.
## Learn more
- [Transform overview](https://docs.unstructured.io/transform/overview)
- [Transform quickstart](https://docs.unstructured.io/transform/quickstart)
- [Install guides for other tools](https://docs.unstructured.io/transform/install/overview)
- [Unstructured Transform](https://transform.unstructured.io)
## License
[MIT](https://github.com/unstructured-io/transform-gemini-extension/blob/HEAD/LICENSE)
Details Type Plugins Topic Files & documents Publisher unstructured-io Source gemini Category Tools Version 0.1.0 Proposed changes 2 Last update 2026-07-28T10:45:33Z Project status Active Language Shell License MIT Added 2026-08-30 14:13:39 Updated 2026-08-30 14:13:39 Source id unstructured-io/transform-gemini-extensionMore 
