home / mcp / doppler mcp server

Doppler MCP Server

An mcp server for doppler based authentication management

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aledlie-doppler-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/doppler-mcp-server/build/index.js"
      ]
    }
  }
}

Doppler MCP Server provides a seamless bridge between MCP-compatible clients and the Doppler CLI, enabling you to manage secrets, projects, configs, and environments through natural language interactions. It wraps the Doppler CLI so you can perform common secrets operations directly from your MCP client.

How to use

You connect your MCP client to the Doppler MCP Server to manage secrets and configurations using natural language prompts. The server exposes Doppler CLI operations as MCP tools, so you can perform actions like listing projects, creating configs, reading secrets, and injecting Doppler secrets into commands.

How to install

Prerequisites: install and configure the Doppler CLI on your machine, and ensure you have Node.js 18 or higher.

Install and build the server from source by following these steps.

# Clone or navigate to the Doppler MCP Server directory
# cd doppler-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Run and connect with a client

You can run the server locally and connect it to an MCP client in either stdio (local process) mode or by configuring your Claude Desktop or other MCP client.

# Run the server directly (example if you want to start it from Node build)
node build/index.js

Configuration

Configure your MCP client to connect to the Doppler MCP Server as a local stdio server. The project demonstrates a few concrete configuration patterns for Claude Desktop and other MCP clients.

{
  "mcpServers": {
    "doppler": {
      "command": "node",
      "args": ["/absolute/path/to/doppler-mcp-server/build/index.js"]
    }
  }
}

Notes on authentication and usage

The server relies on the Doppler CLI authentication. Ensure you are logged in to Doppler before using the server so the CLI can perform authenticated actions.

doppler login

doppler me

Available tools

doppler_secrets_get

Get a specific secret value by name, optionally scoped to a project and config.

doppler_secrets_list

List all secrets within a given project/config.

doppler_secrets_set

Set or update a secret value for a given name within a project/config.

doppler_secrets_delete

Delete a secret by name from a project/config.

doppler_projects_list

List all Doppler projects accessible to your account.

doppler_projects_create

Create a new Doppler project with a given name and optional description.

doppler_configs_list

List all configs within a specific project.

doppler_configs_create

Create a new config with a name, associated project, and environment.

doppler_environments_list

List all environments within a Doppler project.

doppler_run

Run a shell command with Doppler secrets injected into the environment.

doppler_me

Retrieve information about the authenticated Doppler user.