Infisical MCP Server

🚀 Infisical Model Context Protocol Server

The Infisical Model Context Protocol server allows you to integrate with the Infisical API through function calls. This protocol supports various tools to interact with Infisical.

🚀 Quick Start

✨ Features

The Infisical MCP server enables seamless integration with the Infisical API via function calls, and the protocol supports multiple tools for interacting with Infisical.

📦 Installation

To use the MCP server, you must first set the required environment variables for authentication:

• INFISICAL_UNIVERSAL_AUTH_CLIENT_ID: The Machine Identity universal authentication client ID for authentication.
• INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET: The Machine Identity universal authentication client secret for authentication.
• INFISICAL_HOST_URL: Optional Set a custom host URL. This is useful when using self - hosted Infisical or dedicated infrastructure. The default is https://app.infisical.com.

Run the Infisical MCP server using npx:

npx -y @infisical/mcp

💻 Usage Examples

Basic Usage

Using in Claude Desktop

Add the following content to your claude_desktop_config.json file. For more details, refer to here.

{
  "mcpServers": {
    "infisical": {
      "command": "npx",
      "args": ["-y", "@infisical/mcp"],
      "env": {
        "INFISICAL_HOST_URL": "https://<custom-host-url>.com", // Optional
        "INFISICAL_UNIVERSAL_AUTH_CLIENT_ID": "<machine-identity-universal-auth-client-id>",
        "INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET": "<machine-identity-universal-auth-client-secret>"
      }
    }
  }
}

Advanced Usage

Available Tools

🔧 Technical Details

Debugging the Server

To debug the server, you can use the MCP Inspector.

First, build the server:

npm run build

Run the following command in the terminal:

# Start the MCP Inspector and the server
npx @modelcontextprotocol/inspector node dist/index.js

Steps

1. Set the environment variables. Refer to the Installation section.
2. Run the command to start the MCP Inspector.
3. Open the MCP Inspector UI in your browser and click "Connect" to start the MCP server.
4. You can view all available tools and test them one by one.