Nudocs MCP Server

An MCP (Model Context Protocol) server for Nudocs.ai - a document processing service by Nutrient.

Features

This MCP server provides the following tools for working with Nudocs documents:

• list_documents - List all Nudocs documents
• read_document - Read document content as Markdown
• get_document_access_link - Get a shareable access link to a document
• download_document - Download documents in various formats
• upload_file - Upload files to Nudocs
• delete_document - Delete documents by ID

Supported File Formats

Input formats (upload):

• Markdown (.md)
• HTML (.html, .xhtml)
• LaTeX (.latex, .tex)
• reStructuredText (.rst)
• Org mode (.org)
• Textile (.textile)
• DocBook XML
• EPUB (.epub)
• MediaWiki (.wiki)
• Jupyter Notebook (.ipynb)
• OpenDocument Text (.odt)
• Microsoft Word (.doc, .docx)
• Rich Text Format (.rtf)
• Plain Text (.txt)
• PDF (.pdf)

Output formats (download):

• Markdown (.md)
• HTML (.html, .xhtml)
• LaTeX (.latex, .tex)
• PDF (.pdf)
• reStructuredText (.rst)
• Org mode (.org)
• Textile (.textile)
• DocBook XML
• EPUB (.epub)
• Microsoft Word (.doc, .docx)
• OpenDocument Text (.odt)
• Rich Text Format (.rtf)
• Plain Text (.txt)
• MediaWiki (.wiki)
• AsciiDoc (.adoc, .asciidoc)
• Jupyter Notebook (.ipynb)

Prerequisites

• Node.js >= 18.0.0
• A Nudocs account with an API key (sign up at nudocs.ai)

Configuration

Environment Variables

Set your Nudocs API key:

export NUDOCS_API_KEY=your_api_key_here

You can find your API key in your Nudocs account settings.

Integration

Claude Desktop

Add this server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nudocs": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/nudocs-mcp-server"],
      "env": {
        "NUDOCS_API_KEY": "your_api_key_here"
      }
    }
  }
}

After updating the configuration, completely quit and restart Claude Desktop. You'll see an MCP indicator in the bottom-right corner of the chat input when successfully connected.

Claude Code

Claude Code supports three configuration levels:

Local Configuration (Project-specific)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "nudocs": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/nudocs-mcp-server"],
      "env": {
        "NUDOCS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Global Configuration (All projects)

Create or edit ~/.claude.json:

{
  "mcpServers": {
    "nudocs": {
      "command": "npx",
      "args": ["-y", "@nutrient-sdk/nudocs-mcp-server"],
      "env": {
        "NUDOCS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Using the CLI

You can also use Claude Code's built-in configuration wizard:

claude mcp add --transport stdio nudocs --env NUDOCS_API_KEY=YOUR_KEY -- npx -y @nutrient-sdk/nudocs-mcp-server

OpenAI Codex

OpenAI Codex supports MCP servers through its CLI and IDE extension.

Using the CLI

The easiest way to add the Nudocs MCP server:

codex mcp add nudocs --env NUDOCS_API_KEY=YOUR_KEY -- npx -y @nutrient-sdk/nudocs-mcp-server

Manual Configuration

Edit ~/.codex/config.toml to add the server:

[mcp.nudocs]
command = "npx"
args = ["-y", "@nutrient-sdk/nudocs-mcp-server"]

[mcp.nudocs.env]
NUDOCS_API_KEY = "your_api_key_here"

The configuration file is shared between the Codex CLI and IDE extension, so you only need to configure it once.

For more information, visit the OpenAI Codex MCP documentation.

Development

Building from Source

npm install
npm run build

Running Locally

npm run dev

Testing with MCP Inspector

The MCP Inspector allows you to test the server interactively:

npm run inspector

Issues & Support

Report issues at: https://github.com/PSPDFKit/nudocs-mcp-server/issues

License

See LICENSE file for details.

Made by Nutrient | Powered by Nudocs.ai