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.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. 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.

  3. 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.

Try MarkItDown in Claude Code

Free to start, and tool calls cost nothing on any plan.