Skip to main content
Connect your OpenAI agent to Doconda so it can convert, create and edit Word, PowerPoint, Excel and PDF files. With the OpenAI API it uses the SDK tools through function calling; in OpenAI Codex, the MCP server.

Capabilities

  • Create a Word, PowerPoint, Excel or PDF file, or an artifact, from a request or from Markdown the agent wrote.
  • Edit a file: only what is asked changes, and get_report lists every change.
  • Convert a file to another format with no AI, for example any file to Markdown so the agent can read it.
  • Read what people saved in an artifact, such as poll votes.

Setup

This integration uses a Doconda API key in DOCONDA_API_KEY (from API keys). The OpenAI client reads your OpenAI key from OPENAI_API_KEY.

With Python

With TypeScript

The loop ends when the model stops calling tools; its last message includes the document’s download links. With the AI SDK, the same works with openai("gpt-5") from @ai-sdk/openai.

OpenAI Codex

In ~/.codex/config.toml:
Codex can then convert, create and edit documents. Ask it, for example, “make an Excel file with this project’s costs”.

Tools

The agent gets the eight Doconda tools; see the tools for what each one does. doconda.tools() returns them with name, description, a JSON Schema (inputSchema in TypeScript, input_schema in Python) and run. A failed call returns { "error": "<code>", "message": "…" } instead of raising, so the model can correct itself.

Troubleshooting

  • Doconda: pass api_key or set DOCONDA_API_KEY. — The SDK found no key (in TypeScript: Doconda: pass { apiKey } or set DOCONDA_API_KEY.). Set DOCONDA_API_KEY, or pass the key to Doconda.
  • A tool result has "error": "insufficient_balance" — The project’s balance can’t cover the document: top up in the dashboard, or ask for quality: "fast".
  • The download link stopped working — File links expire after 5 minutes; the agent calls get_document for fresh ones.