Skip to content

MarkItDown MCP and API

MarkItDown converts local PDF, Office, HTML and other files into Markdown. An agent can convert documents into Markdown for research and extraction. Longwave installs the MarkItDown MCP server and runs it on your machine, with no account or key.

Add to Longwave

Install elsewhere

Install MarkItDown

Choose a harness. These instructions start the same local MCP server shown on this page.

Claude Code

Run this in your terminal. It adds a user-scoped server; use --scope project instead if it should apply only to the current project.

terminal
claude mcp add --scope user --transport stdio markitdown -- uvx markitdown-mcp
functions
1
access
Runs locally

Use MarkItDown on Longwave

  1. Download Longwave or open app.longwave.run.
  2. Longwave installs the MarkItDown MCP server and runs it on your machine, with no account or key.
  3. Ask for the result in any thread, for example: “Convert a PDF into Markdown for review”. The agent picks the MarkItDown function and calls it.

MarkItDown functions

Function
convert_to_markdown Convert a resource described by an http:, https:, file: or data: URI to markdown

Use cases

Questions people ask

Which file types can MarkItDown convert?

MarkItDown supports formats including PDF, Word, Excel, PowerPoint and HTML. Optional dependencies enable some format-specific conversion features. MarkItDown documentation

Does MarkItDown preserve a document page layout?

MarkItDown extracts content into Markdown for text processing. It does not aim to reproduce the original visual page layout. MarkItDown documentation

How do I add the MarkItDown MCP server to Claude Code?

Run claude mcp add markitdown -- uvx markitdown-mcp in a terminal. Longwave installs the MarkItDown MCP server and runs it on your machine, with no account or key.

Who publishes the MarkItDown MCP server?

Microsoft publishes the MarkItDown MCP server that Longwave installs. Source code

Use MarkItDown in Longwave

Call MarkItDown from any agent thread, on your machine or in the cloud.

Add to Longwave