Infisical Model Context Protocol

by mikeysrecipes

3.3k downloads Not rated yet Apache-2.0 license

About

# Infisical Model Context Protocol The Infisical [Model Context Protocol](https://modelcontextprotocol.com/) server allows you to integrate with Infisical APIs through function calling. This protocol supports various tools to interact with Infisical. ## Setup ### Environment variables In order to use the MCP server…

Details

License
Apache-2.0 license

Explore

- Create, read, update, and delete secrets
- List all secrets in a project
- Create new projects and environments
- Create folders within projects
- Invite members to projects

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Infisical Model Context Protocol
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

In order to use the MCP server, you must first set the environment variables required for authentication.

- INFISICAL_UNIVERSAL_AUTH_CLIENT_ID: The Machine Identity universal auth client ID that will be used for authentication
- INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET: The Machine Identity universal auth client secret that will be used for authentication.
- INFISICAL_HOST_URL: Optionally set a custom host URL. This is useful if you're self-hosting Infisical or you're on dedicated infrastructure. Defaults to https://app.infisical.com

To run the Infisical MCP server using npx, use the following command:

npx -y @infisical/mcp

Add the following to your claude_desktop_config.json. See here for more details.

{
  "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_ID": "<machine-identity-universal-auth-client-secret"
      }
    }
  }
}

create-secret

Create a new secret

delete-secret

Delete a secret

update-secret

Update a secret

list-secrets

Lists all secrets

get-secret

Get a single secret

create-project

Create a new project

create-environment

Create a new environment

create-folder

Create a new folder

invite-members-to-project

Invite one or more members to a project

| Tool | Description |
| --------------------------- | --------------------------------------- |
| create-secret | Create a new secret |
| delete-secret | Delete a secret |
| update-secret | Update a secret |
| list-secrets | Lists all secrets |
| get-secret | Get a single secret |
| create-project | Create a new project |
| create-environment | Create a new environment |
| create-folder | Create a new folder |
| invite-members-to-project | Invite one or more members to a project |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "infisical model context protocol": {
            "infisical-mcp-server-mikeysrecipes": {
                "command": "npx",
                "args": [
                    "-y",
                    "@infisical/mcp"
                ]
            }
        }
    }
}

McpServers

{
    "infisical-mcp-server-mikeysrecipes": {
        "command": "npx",
        "args": [
            "-y",
            "@infisical/mcp"
        ]
    }
}

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

Setup

Environment variables

In order to use the MCP server, you must first set the environment variables required for authentication.

- INFISICAL_UNIVERSAL_AUTH_CLIENT_ID: The Machine Identity universal auth client ID that will be used for authentication
- INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET: The Machine Identity universal auth client secret that will be used for authentication.
- INFISICAL_HOST_URL: Optionally set a custom host URL. This is useful if you're self-hosting Infisical or you're on dedicated infrastructure. Defaults to https://app.infisical.com

To run the Infisical MCP server using npx, use the following command:

npx -y @infisical/mcp

Usage with Claude Desktop

Add the following to your claude_desktop_config.json. See here for more details.

{
  "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_ID": "<machine-identity-universal-auth-client-secret"
      }
    }
  }
}

Available tools

| Tool | Description |
| --------------------------- | --------------------------------------- |
| create-secret | Create a new secret |
| delete-secret | Delete a secret |
| update-secret | Update a secret |
| list-secrets | Lists all secrets |
| get-secret | Get a single secret |
| create-project | Create a new project |
| create-environment | Create a new environment |
| create-folder | Create a new folder |
| invite-members-to-project | Invite one or more members to a project |

Debugging the Server

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

First build the server

npm run build

Run the following command in your terminal:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.