X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Mathpix to Claude

Connect Claude Web, Desktop and Cowork to Mathpix MCP. Extract latex from equation image, parse photographed table into csv, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Mathpix logoMathpix
Api Key

Mathpix extracts text, mathematics, tables, and other structured content from images and documents. Converts visual content into editable formats for publishing, computation, and archival.

28 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Mathpix account to Claude via Composio Connect, enabling it to extract LaTeX from equation image, parse photographed table into CSV, summarize handwritten notes from photo, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Mathpix with

ChatGPT WorkHermes

Connecting Mathpix to Claude Web, Desktop, and Cowork

1. Open Customize

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

2. Add the Composio MCP server

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

3. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

4. Connect your Mathpix account

Back in Claude, ask it to connect to Mathpix or give it any Mathpix-related task.

For example, ask Claude to:

  • "Extract LaTeX from equation image"
  • "Parse photographed table into CSV"
  • "Summarize handwritten notes from photo"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Mathpix account is ready to use.

What is the Mathpix Claude Connector, and what's possible with it?

The Mathpix MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Mathpix account. It provides structured and secure access so your agent can perform Mathpix operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Mathpix?

The connector can show as connected, but Claude must use it in each Mathpix conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Mathpix again.

2. Why does Claude show an MCP server error before Mathpix connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Mathpix.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Mathpix.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Mathpix authorization link not work?

The Composio connector is one server. Your Mathpix account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Mathpix connection.
  • Composio creates a fresh Mathpix authorization link.
  • Open that link in your browser and finish the Mathpix sign-in.

4. Why do Mathpix actions fail after they worked before?

The Mathpix connection can expire or lose permission.

  • Ask Claude to inspect the Mathpix connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Mathpix account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Mathpix.
  • If the action still fails with a permission error, check that the connected account has that permission in Mathpix itself.

5. How do I switch to a different Mathpix account?

Claude can manage the Mathpix connection for you.

  • Ask Claude to disconnect or delete the current Mathpix account.
  • Ask Claude to connect Mathpix again.
  • Open the new Composio authorization link for Mathpix.
  • Sign in with the other Mathpix account in the browser.
  • After the account connects, ask Claude to retry the Mathpix task.

6. Why is my Mathpix connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Mathpix connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Mathpix tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Mathpix.
TOOLS

Supported Tools

Every Mathpix action and event your agent gets out of the box.

Convert Mathpix Markdown

Submit Mathpix Markdown, wait for one requested format to finish, then return the conversion ID and downloadable output file.

Create App Token

Mint a short-lived client OCR credential, optionally with a live ink strokes session.

Delete Conversion

Permanently delete one Mathpix Markdown conversion's hosted output data after explicit confirmation.

Delete Document

Permanently delete one Mathpix document source and its hosted outputs after explicit confirmation.

Delete File

Permanently delete one terminal Files API file and its Mathpix-hosted results.

Finalize File Job

Permanently close one Files API job to new file additions and arm its completion webhook.

Get App Token

Get expiry and ownership metadata for a specific short-lived Mathpix app token.

Get Conversion Result

Wait for an existing Mathpix Markdown conversion and requested format to finish, then return its status and downloadable output file without creating a conversion.

Get Document Result

Wait for an existing Mathpix document job and requested format to finish, then return its status and downloadable output file without creating a new job.

Get File Job

Get aggregate status, file and page counters, and timestamps for one Files API job.

Get File Result

Wait for an existing Files API file and selected format to finish, then return its status and downloadable output without creating a file.

Get Job File by Custom ID

Get the complete Files API processing status for one job member using the exact caller-defined custom ID assigned at submission.

Get OCR Usage

Return one page of aggregated Mathpix OCR usage for a date range, optionally grouped by usage type, request configuration, or application.

Get Storage Onboarding Identities

Get the Mathpix AWS, Azure, and GCP identities needed to grant cloud-storage access.

List Conversions

List one page of retained Mathpix Markdown conversion records, optionally filtered by date, and return IDs usable by conversion result or deletion tools.

List Data Sources

List cloud-storage data sources registered with Mathpix, returning only allowlisted non-secret metadata.

List Documents

List retained document OCR jobs for the connected account, optionally filtered by date or document ID, and return one page.

List File Job Files

List one cursor-paginated page of files in a Mathpix Files API job, optionally filtered by terminal status.

List File Jobs

List one cursor-paginated page of Files API jobs newest first, optionally bounded by inclusive UTC dates.

OCR Document

Submit a PDF, office document, or ebook URL, wait for OCR and the requested conversion to finish, then return its Mathpix job ID and downloadable output file.

OCR Image

Extract text, math, tables, diagrams, or chemistry from one image URL or base64 data URI and return the requested OCR representations.

Process File URI

Submit one public or registered-cloud document URI to the paid Files API, wait for OCR and one requested output, and return the retained file ID and downloadable result.

Process Image Batch

Submit a paid asynchronous batch of 1-100 named public image URLs, wait until every key has a semantically successful OCR result, and return the retained batch ID and results.

Recognize Strokes

Recognize handwritten math or text from aligned x/y digital-ink stroke arrays and return OCR representations.

Revoke App Token

Irreversibly revoke one short-lived app token immediately.

Search OCR Results

Search retained image and stroke OCR history by date, identifiers, content, tags, or detected content and return one page of results.

Submit File Job

Submit 1 to 200,000 remote documents as one paid asynchronous Mathpix Files job.

Upload and Process File

Upload one local document to the paid Mathpix Files API, wait until OCR and one requested output are ready, then return the retained Mathpix file ID and a downloadable result.

FRAMEWORKS

How to build Mathpix MCP Agent with another framework

ChatGPT Work logo

ChatGPT Work

Use Mathpix MCP with ChatGPT Work

Hermes logo

Hermes

Use Mathpix MCP with Hermes

FAQ

Frequently asked questions

With a standalone Mathpix MCP server, the agents and LLMs can only access a fixed set of Mathpix tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Mathpix and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Mathpix tools.

Yes, absolutely. You can configure which Mathpix scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Mathpix data and credentials are handled as safely as possible.

Start with Mathpix.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Mathpix tool your agent needs.Free to start.

Start building