XLSX.now MCP Server

Convert XLSX spreadsheets to XLS, CSV, PDF, JPG, HTML and ODS, or create XLSX files from CSV, XLS and ODS.

Hosted MCP Server

npx add-mcp 'https://xlsx.now/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

What is the XLSX.now MCP server?

It lets an AI assistant use XLSX.now converters as structured tools. The client can discover supported routes, start a conversion, check its status, and return a secure download URL.

MCP endpoint

https://xlsx.now/mcp

The server uses stateless Streamable HTTP transport. Your client must support remote HTTP servers and custom authentication headers.

Connect XLSX.now to Codex

  1. 1 Create an API key Sign in and open Dashboard → API Access.
  2. Save the key
    export XLSXNOW_API_KEY="xlsxnow_your_key_here"
    
  3. Add the remote server
    codex mcp add xlsx-now \
      --url https://xlsx.now/mcp \
      --bearer-token-env-var XLSXNOW_API_KEY
    
  4. Check the connection
    codex mcp get xlsx-now
    

Connect other MCP clients

Configuration names vary, but the URL and authentication header are the same:

{
  "mcpServers": {
    "xlsx-now": {
      "url": "https://xlsx.now/mcp",
      "headers": { "X-Api-Key": "xlsxnow_your_key_here" }
    }
  }
}

Authentication

Create or regenerate the key in the API dashboard. You may also send it as Authorization: Bearer …. It uses the same credits, limits, and ownership rules as the REST API and is never returned in tool output.

Verify the MCP connection

Ask your client: “List the available XLSX.now converters.” This calls list_converters without using credits. Then ask for API usage to confirm authentication.

If it fails: 401 means an invalid key; 402 means insufficient credits; 429 means the request limit was reached.

XLSX.now MCP tools

ToolPurposeCredits
list_convertersSearch valid conversion routes and formats.No
convert_image_urlFetch a public URL and start the selected conversion. The legacy name is retained for API compatibility.Yes
get_conversion_statusCheck a job and obtain its temporary download.No
get_api_usageRead credits, recent usage, and limits.No

Example workflow

Ask your assistant:

Use the xlsx-to-pdf converter for the file at this public URL, wait for it to finish, and return the download link.

Security and limits

  • Only public HTTP and HTTPS source URLs are accepted.
  • Private, loopback, link-local, and reserved addresses are blocked.
  • Every redirect is validated before it is followed.
  • Source downloads are size-limited and use temporary storage.
  • Files follow the normal XLSX.now retention policy.

Prefer direct HTTP integration? Read the XLSX.now REST API documentation.