DocuSeal MCP Server

MCP server for DocuSeal document signing and template management. This server provides tools to interact with DocuSeal's API for managing templates, submissions, and submitters.

Features

Templates

• List all templates with filtering options

• Get detailed template information

• Clone existing templates

• Archive templates

• Create templates from PDF files

Submissions

• List submissions with filtering

• Get detailed submission information

• Create new submissions for document signing

• Archive submissions

Submitters

• List submitters with filtering

• Get detailed submitter information

• Update submitter details and field values

• Re-send email notifications

Related MCP server: SendForSign MCP Server

Installation

Via NPX (Recommended)

npx docuseal-mcp

Via NPM Global Install

npm install -g docuseal-mcp

Configuration

1. Get Your API Key

1. Visit DocuSeal Console

2. Copy your X-Auth-Token

2. Configure Claude Desktop

Add the server to your Claude Desktop configuration file with your API key.

Important: The API key MUST be configured in the environment - it's the only way to authenticate with DocuSeal.

macOS

File location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

File location: %APPDATA%/Claude/claude_desktop_config.json

Configuration Content

{
  "mcpServers": {
    "docuseal": {
      "command": "npx",
      "args": ["-y", "docuseal-mcp"],
      "env": {
        "DOCUSEAL_API_KEY": "your-api-key-here"
      }
    }
  }
}

If installed globally:

{
  "mcpServers": {
    "docuseal": {
      "command": "docuseal-mcp",
      "env": {
        "DOCUSEAL_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart Claude Desktop

After updating the configuration, restart Claude Desktop to load the MCP server with your API key.

Available Tools

Template Management

docuseal_list_templates

List all document templates from DocuSeal.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• application_key (optional): Filter by application key

• folder (optional): Filter by folder name

• archived (optional): Get archived templates instead of active ones

• limit (optional): Number of templates to return (max 100, default 10)

docuseal_get_template

Get detailed information about a specific template.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• template_id (required): The unique identifier of the template

docuseal_clone_template

Clone an existing template into a new template.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• template_id (required): The unique identifier of the template to clone

• name (optional): Name for the new cloned template

• folder_name (optional): Folder name for the cloned template

• application_key (optional): Application key for the cloned template

docuseal_archive_template

Archive (soft delete) a template.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• template_id (required): The unique identifier of the template to archive

docuseal_create_template_from_pdf

Create a template from an existing PDF with form fields.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• name (required): Name for the template

• documents (required): Array of documents with fields configuration

• folder_name (optional): Folder name for the template

• application_key (optional): Application key for the template

Submission Management

docuseal_list_submissions

List all submissions with optional filtering.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• template_id (optional): Filter by template ID

• application_key (optional): Filter by application key

• template_folder (optional): Filter by template folder name

• limit (optional): Number of submissions to return (max 100, default 10)

docuseal_get_submission

Get detailed information about a specific submission.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• submission_id (required): The unique identifier of the submission

docuseal_create_submission

Create a new submission for document signing.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• template_id (required): Template ID to create submission from

• submitters (required): Array of submitters for the document

• send_email (optional): Whether to send email notifications (default: true)

• order (optional): Order of submitters signing ('preserved' or 'random', default: 'preserved')

• message (optional): Custom email message with subject and body

docuseal_archive_submission

Archive (soft delete) a submission.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• submission_id (required): The unique identifier of the submission to archive

Submitter Management

docuseal_list_submitters

List all submitters with optional filtering.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• submission_id (optional): Filter by submission ID

• application_key (optional): Filter by application key

• limit (optional): Number of submitters to return (max 100, default 10)

docuseal_get_submitter

Get detailed information about a specific submitter.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• submitter_id (required): The unique identifier of the submitter

docuseal_update_submitter

Update submitter details, field values, and re-send emails.

Note: API key is automatically used from the DOCUSEAL_API_KEY environment variable configured in Claude Desktop.

• submitter_id (required): The unique identifier of the submitter

• name (optional): Submitter name

• email (optional): Submitter email

• phone (optional): Submitter phone

• values (optional): Field values to update

• send_email (optional): Whether to re-send email notification

• message (optional): Custom email message with subject and body

Example Usage

Once configured with Claude Desktop, you can use natural language to interact with DocuSeal:

• "List all my DocuSeal templates"

• "Create a new submission for template ID 123 with John Doe's email"

• "Get the status of submission 456"

• "Clone template 789 with a new name"

• "Archive the old contract template"

Note: Since your API key is configured in the environment, you don't need to provide it in your requests to Claude!

Development

Local Development

1. Clone the repository

2. Install dependencies: npm install

3. Build the project: npm run build

4. Test locally: npm run dev

Building

npm run build

The built files will be in the build/ directory.

API Documentation

For more detailed API documentation, visit:

• DocuSeal API Documentation

• DocuSeal Console

License

MIT

Support

For support with this MCP server, please open an issue on GitHub.

For DocuSeal API support, visit DocuSeal's documentation.