Connect MarkItDown to Claude Code
Convert web pages and documents. PDF, Word, Excel, PowerPoint, HTML, CSV, EPUB and more, to Markdown an agent can read. Add Toolspoke to Claude Code once and it can use 3 MarkItDown actions. Your MarkItDown credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install MarkItDown and connect it
Add MarkItDown to a project in your Toolspoke workspace.
MarkItDown needs no credential. Install it and it works, and there is nothing of yours for Toolspoke to hold.
Choose what Claude Code may do
All 3 actions only read, and any of them can be switched off for a project.
What you can ask Claude Code for
A few of the MarkItDown actions that only read, so they are safe to try first.
- Report the installed MarkItDown version
- Fetch a web page or a document at a public URL and return it as Markdown
- Convert a file that is already in the project's sandbox workspace to Markdown
What Claude Code can do in MarkItDown
3 actions read.
Reads
Version
Report the installed MarkItDown version. Needs no network and no input, which is why it is the health check.
Convert url
Fetch a web page or a document at a public URL and return it as Markdown. Works for HTML pages, Wikipedia articles, YouTube videos (title, description and transcript when one exists), RSS feeds, and links straight to a PDF, DOCX, XLSX or PPTX. The sandbox reaches the public internet only; private and loopback addresses are not routable. Output is truncated at 100,000 characters.
Convert file
Convert a file that is already in the project's sandbox workspace to Markdown. PDF, DOCX, PPTX, XLSX, XLS, CSV, HTML, JSON, XML, EPUB, Jupyter notebook, ZIP (each member converted) or Outlook MSG. Relative paths resolve against /workspace. The file has to be there first, for example written by the Bash connector or downloaded with curl. Output is truncated at 100,000 characters.
MarkItDown in Claude Code: questions
Does Claude Code see my MarkItDown credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Will 3 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the MarkItDown action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan. MarkItDown runs in a sandbox, so a call bills the sandbox time it uses.
MarkItDown in your other apps
Try MarkItDown in Claude Code
Free to start, and tool calls cost nothing on any plan.