Doppler MCP Server

A Model Context Protocol (MCP) server that wraps the Doppler CLI for seamless secrets management integration with Claude and other MCP clients.

Overview

This MCP server provides a bridge between MCP-compatible applications (like Claude Desktop) and the Doppler CLI, allowing you to manage secrets, projects, configs, and environments through natural language interactions.

Prerequisites

• Node.js 18 or higher

• Doppler CLI installed and authenticated

• An active Doppler account with appropriate permissions

Installation

From Source

Configuration

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

Other MCP Clients

For other MCP clients, configure them to run:

Available Tools

The server exposes the following Doppler CLI operations as MCP tools:

Secrets Management

• doppler_secrets_get - Get a specific secret value

  • Parameters: name (required), project, config

• doppler_secrets_list - List all secrets in a config

  • Parameters: project, config

• doppler_secrets_set - Set a secret value

  • Parameters: name (required), value (required), project, config

• doppler_secrets_delete - Delete a secret

  • Parameters: name (required), project, config

Project Management

• doppler_projects_list - List all projects

  • Parameters: none

• doppler_projects_create - Create a new project

  • Parameters: name (required), description

Config Management

• doppler_configs_list - List all configs in a project

  • Parameters: project

• doppler_configs_create - Create a new config

  • Parameters: name (required), project (required), environment (required)

Environment Management

• doppler_environments_list - List all environments in a project

  • Parameters: project

Utility

• doppler_run - Run a command with Doppler secrets injected

  • Parameters: command (required), project, config

• doppler_me - Get information about the authenticated user

  • Parameters: none

Usage Examples

Once configured, you can interact with Doppler through your MCP client:

Authentication

This server uses the Doppler CLI's authentication. Make sure you've authenticated the Doppler CLI before using this server:

You can verify your authentication status:

Development

Build

Watch Mode

How It Works

This server:

1. Listens for MCP tool requests via stdio

2. Translates tool calls into Doppler CLI commands

3. Executes the commands using your local Doppler CLI installation

4. Returns the results in JSON format back to the MCP client

Troubleshooting

"Command not found: doppler"

Make sure the Doppler CLI is installed and available in your PATH:

"Authentication required"

Authenticate with Doppler:

Server not appearing in Claude Desktop

1. Check that the path in claude_desktop_config.json is correct and absolute

2. Restart Claude Desktop completely

3. Check the Claude Desktop logs for errors

Security Considerations

• This server executes Doppler CLI commands with the permissions of the authenticated user

• Secrets are transmitted through the MCP protocol - ensure your MCP client is trusted

• The server does not store any secrets, it only proxies requests to the Doppler CLI

License

MIT

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.