Doc2X MCP: Codex

Back: Doc2X MCP Guide

This page uses Codex CLI as an example to show how to add Doc2X MCP as a local MCP server and call it in chat.

What You Need

• Node.js (LTS recommended) and npx
• DOC2X_API_KEY
• (Optional) proxy env (HTTPS_PROXY / HTTP_PROXY)

Add MCP Configuration

Run in your terminal:

codex mcp add doc2x --env DOC2X_API_KEY=sk-XXX -- npx -y @noedgeai-org/doc2x-mcp@0.1.0

Check MCP

Open the MCP list in your Codex session (entry point may vary by version):

• Type /mcp and press Enter
• Or use the MCP/Tools entry in the UI

You should see a doc2x MCP server and it should be available (you can expand it to view the tool list).

Use doc2x-mcp

Try a minimal, verifiable flow first:

• Put the target PDF in your current working directory (or provide an accessible absolute path)
• In chat, explicitly ask the model to use the doc2x MCP server to parse and export, and provide the file name

Example prompts (replace with your file name):

• Use doc2x-mcp to parse ./paper.pdf and export it as Markdown.
• Use doc2x-mcp to parse ./paper.pdf, then tell me the exported file path.

Please wait a moment. Once parsing completes, the results will be exported.

Troubleshooting

• If the server doesn’t show up, re-check the MCP configuration and restart/refresh the session.
• If dependency installation fails, verify npx -y @noedgeai-org/doc2x-mcp@0.1.0 works in your terminal first.