# Give a CrewAI agent document tools with Reducto

> Decorate a function with @tool from crewai.tools that calls client.parse.run from the Reducto Python SDK, then give it to an Agent in your crew.

Canonical: https://reducto.ai/tools/reducto-tool-crewai  
Last updated: 2026-11-15  
For: Python developers using CrewAI

## How to do it

1. pip install crewai reductoai.
2. Copy reducto_crewai.py.
3. Add parse_document to an Agent's tools.
4. Kick off the crew.

## Limits and pricing

- Uses your Reducto API key and its limits.
- No-key fallbacks: 5 pages per document, per-IP rate limit.
- Pricing is per page; see the pricing page.
- Pricing: https://reducto.ai/pricing

## When to use what

- **This tool definition**: when your own agent code decides when to read a document.
- **The hosted MCP server**: when the agent runs in an MCP client (Claude, Cursor, Codex, VS Code).
- **/read or /api/tools**: for one short document without a key.

## FAQ

### Is there an official CrewAI integration?

Not yet: this is a custom tool on the official Reducto Python SDK. CrewAI agents can also use the hosted MCP server.

### Where does the API key come from?

Create one at studio.reducto.ai (15,000 free credits), or let the agent sign up over HTTP by following reducto.ai/auth.md. The SDKs read REDUCTO_API_KEY from the environment.

### Can the agent try it without an API key?

Yes, for short documents: GET https://reducto.ai/read/<public URL> returns Markdown, and POST https://reducto.ai/api/tools/<tool> takes a file. Both are free up to 5 pages with a per-IP limit.

### How is it billed?

In credits per page. See the pricing page and the credit usage docs for current rates.

Sample document (synthetic): https://reducto.ai/tools/samples/harborline-bank-statement.pdf

## Related

- [CrewAI custom tools](https://docs.crewai.com/en/learn/create-custom-tools)
- [Python SDK docs](https://docs.reducto.ai/sdk/python/overview)
- [All agent recipes](https://reducto.ai/tools/agents)
