External API Tools

Use Write2Notes from your terminal, MCP client, Codex, or Claude

The agent tools package gives subscribers a CLI, MCP server, and agent skills for checking credits, converting files, compiling LaTeX with figures, and refining previous outputs.

Create API key Open GitHub repo

One link for agent setup

Paste the repo link or the prompt below into Codex or Claude. The agent can install the package, read the matching skill instructions, and configure MCP without seeing your raw API key.

https://github.com/write2notes/write2notes-agent-tools

Install the Write2Notes Agent Tools from https://github.com/write2notes/write2notes-agent-tools. Set up the CLI, configure MCP if available, and use the matching Codex or Claude skill instructions. Do not ask me to paste my API key into chat; tell me how to set WRITE2NOTES_API_KEY in my local shell or MCP environment.

Install locally

During invite-only beta, GitHub access may be required. After installing, set your API key in the local environment and run the readiness check.

1. Install the package

python3 -m pip install "write2notes-agent-tools[mcp] @ git+https://github.com/write2notes/write2notes-agent-tools.git"

2. Set your API key and verify

export WRITE2NOTES_API_KEY="w2n_live_..."
write2notes check

What the tools include

CLI

Convert files, check credits, compile LaTeX, download outputs, and send feedback from a shell.

MCP server

Expose Write2Notes actions as tools for MCP-compatible agents and desktop clients.

Agent skills

Give Codex and Claude concise instructions for safe token handling and correct API workflows.

Conversion controls

Files and outputs

Convert PDF, JPG, PNG, HEIC, or HEIF files into DOCX, Markdown, or LaTeX+PDF. A single request can combine up to 20 files into one output.

Presets and instructions

Choose presets for notes, summaries, exams, homework, problem solving, formula sheets, translation, slides, or custom instructions.

Advanced AI

Use Advanced AI for complex handwriting, diagrams, low-quality scans, and richer figure handling. It costs 3× credits and requires Standard or Premium.

Accessible output

Request accessibility-enhanced DOCX or tagged LaTeX/PDF output with document structure, metadata, headings, and figure alt text where supported. Accessible LaTeX+PDF uses modern PDF tagging; local compilation requires TeX Live 2025 with current packages and LuaLaTeX — pdfLaTeX, XeLaTeX, and other engines will not work.

Accessibility checker

Analyze an existing PDF or DOCX for machine-detectable accessibility problems and receive plain-language remediation guidance.

Automated accessibility checks through the API

Send one PDF or DOCX to POST /v1/accessibility/check. The response reports Pass, Warning, and Fail findings for document structure, metadata, text, figures, tables, equations, and other detectable risks, plus items that still require human review.

Available to Basic, Standard, and Premium subscribers. Checks use no credits, uploaded files are not saved, and website plus API requests share a limit of 30 checks per user per hour. An automated pass is not a WCAG or PDF/UA certification.

Overall result meanings

pass: No machine-detectable failures or review warnings were found. Human review is still required; this is not an accessibility certification.
needs_review: No definite automated failure was found, but warnings or uncertain conditions require human inspection or correction. This is not a clean automated pass.
fail: At least one machine-detectable accessibility requirement is missing or failed. Correct the failed findings and run the checker again.

Check a PDF or DOCX

curl -X POST https://YOUR_V1_API_HOST/v1/accessibility/check \
  -H "Authorization: Bearer $WRITE2NOTES_API_KEY" \
  -F "file=@document.pdf"

Common commands

These commands use the same external API as the dashboard API key page.

write2notes credits
write2notes convert notes.pdf --format latex_pdf --out-dir out
write2notes latex estimate main.tex --figure figures
write2notes latex compile main.tex --figure figures --out-dir out
write2notes feedback SESSION_ID "Make section 2 clearer." --out-dir out

Token handling

API keys are only shown once in the dashboard. Keep them in your local environment or MCP client settings. Do not paste raw keys into prompts, shared files, or public issue trackers.

Manage API keys in your dashboard