Lets AI coding assistants pull and push secure environment variables and secrets through a secure vault with human-in-the-loop protection.
Also known as DinanathDash/Envault, @dinanathdash/envault-mcp-server
- Stars
- 4
- Tools
- —
- Downloads, 30 days
- 234
- Latest version
- 1.12.0
- Last commit
- Nov 1, 2026
- License
- —
What is Envault MCP?
Envault lets AI coding assistants pull and push secure environment variables and secrets through a secure vault with human-in-the-loop protection.
Summary generated from the project's README
About Envault MCP server
Envault provides a secure environment for managing sensitive secrets and variables through a centralized vault. It is designed for developers who need to share credentials within teams using role-based access control, including owner, editor, and viewer permissions. The system uses AES-256-GCM encryption with a master and data key hierarchy to ensure high levels of protection for all stored information.
This server enables AI coding assistants like Claude Desktop, Cursor, and RooCode/Cline to interact with your secrets via the Model Context Protocol. You can set up the integration globally or for specific local workspaces using the envault mcp install command. The tool also features native Vercel integration, allowing you to map environments and sync secrets directly into Vercel env storage for serverless runtime compatibility.
Users can manage their data through a web interface, a terminal-based CLI, or via an SDK. The architecture supports biometric login through Passkey support and organizes secrets into distinct project workspaces for better management.
What you can do with it
- 1Automate secret retrieval for AI assistantsConfigure an AI coding agent to pull necessary environment variables directly from your secure vault during development.
- 2Synchronize secrets with VercelLink your project to Vercel to automatically sync your managed secrets into their environment storage.
- 3Manage secrets via terminalUse the command line interface to handle sensitive data without leaving your development environment.
- 4Collaborate with team membersAssign specific access levels to teammates to control who can read, write, or manage project secrets.
Written from the project's README. Every use case is checked against a quote from it.
How to install Envault MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Envault MCP in Claude Code
$ claude mcp add --env 'ENVAULT_TOKEN=<YOUR_ENVAULT_TOKEN>' --env 'ENVAULT_BASE_URL=<ENVAULT_BASE_URL>' envault -- npx -y @dinanathdash/envault-mcp-serverInstall Envault MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"envault": {
"command": "npx",
"args": [
"-y",
"@dinanathdash/envault-mcp-server"
],
"env": {
"ENVAULT_TOKEN": "<YOUR_ENVAULT_TOKEN>",
"ENVAULT_BASE_URL": "<ENVAULT_BASE_URL>"
}
}
}
}Install Envault MCP in VS Code
.vscode/mcp.json
{
"servers": {
"envault": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dinanathdash/envault-mcp-server"
],
"env": {
"ENVAULT_TOKEN": "<YOUR_ENVAULT_TOKEN>",
"ENVAULT_BASE_URL": "<ENVAULT_BASE_URL>"
}
}
}
}Install Envault MCP in VS Code CLI
$ code --add-mcp '{"name":"envault","type":"stdio","command":"npx","args":["-y","@dinanathdash/envault-mcp-server"],"env":{"ENVAULT_TOKEN":"<YOUR_ENVAULT_TOKEN>","ENVAULT_BASE_URL":"<ENVAULT_BASE_URL>"}}'Install Envault MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"envault": {
"command": "npx",
"args": [
"-y",
"@dinanathdash/envault-mcp-server"
],
"env": {
"ENVAULT_TOKEN": "<YOUR_ENVAULT_TOKEN>",
"ENVAULT_BASE_URL": "<ENVAULT_BASE_URL>"
}
}
}
}Install Envault MCP in Codex
$ codex mcp add envault --env 'ENVAULT_TOKEN=<YOUR_ENVAULT_TOKEN>' --env 'ENVAULT_BASE_URL=<ENVAULT_BASE_URL>' -- npx -y @dinanathdash/envault-mcp-serverInstall Envault MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.envault] command = "npx" args = ["-y", "@dinanathdash/envault-mcp-server"] [mcp_servers.envault.env] ENVAULT_TOKEN = "<YOUR_ENVAULT_TOKEN>" ENVAULT_BASE_URL = "<ENVAULT_BASE_URL>"
Install Envault MCP in Gemini CLI
$ gemini mcp add -s user -e 'ENVAULT_TOKEN=<YOUR_ENVAULT_TOKEN>' -e 'ENVAULT_BASE_URL=<ENVAULT_BASE_URL>' envault npx -- -y @dinanathdash/envault-mcp-serverInstall Envault MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"envault": {
"command": "npx",
"args": [
"-y",
"@dinanathdash/envault-mcp-server"
],
"env": {
"ENVAULT_TOKEN": "<YOUR_ENVAULT_TOKEN>",
"ENVAULT_BASE_URL": "<ENVAULT_BASE_URL>"
}
}
}
}Configuration
ENVAULT_TOKENRequiredSecretRequired: Generate via Envault Account Settings -> Security -> MCP Token
ENVAULT_BASE_URLRequiredRequired: https://www.envault.tech
ENCRYPTION_KEYENVAULT_CLI_URLNEXT_PUBLIC_API_SIGNATURE_SALTNEXT_PUBLIC_SUPABASE_ANON_KEYNEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_VERCEL_INTEGRATION_INSTALL_URLSUPABASE_SERVICE_ROLE_KEYUPSTASH_REDIS_REST_TOKENUPSTASH_REDIS_REST_URLVERCEL_CLIENT_IDVERCEL_CLIENT_SECRETVERCEL_REDIRECT_URIVERCEL_WEBHOOK_SECRET
| Name | Description | |
|---|---|---|
| ENVAULT_TOKEN | Required: Generate via Envault Account Settings -> Security -> MCP Token | RequiredSecret |
| ENVAULT_BASE_URL | Required: https://www.envault.tech | Required |
| ENCRYPTION_KEY | — | |
| ENVAULT_CLI_URL | — | |
| NEXT_PUBLIC_API_SIGNATURE_SALT | — | |
| NEXT_PUBLIC_SUPABASE_ANON_KEY | — | |
| NEXT_PUBLIC_SUPABASE_URL | — | |
| NEXT_PUBLIC_VERCEL_INTEGRATION_INSTALL_URL | — | |
| SUPABASE_SERVICE_ROLE_KEY | — | |
| UPSTASH_REDIS_REST_TOKEN | — | |
| UPSTASH_REDIS_REST_URL | — | |
| VERCEL_CLIENT_ID | — | |
| VERCEL_CLIENT_SECRET | — | |
| VERCEL_REDIRECT_URI | — | |
| VERCEL_WEBHOOK_SECRET | — |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachabledinanathdash/envault is public and reachablegithub.com/dinanathdash/envault ↗Pass
- Package names this repository as its source@dinanathdash/envault-mcp-server names dinanathdash/envault as sourcenpmjs.com/package/@dinanathdash/envault-mcp-server ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @dinanathdash/envault-mcp-servernpmjs.com/package/@dinanathdash/envault-mcp-server/v/1.12.0# ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-01github.com/dinanathdash/envault ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @dinanathdash/envault-mcp-serverPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubEnvault
Envault is a secure, modern vault application built with Next.js, Supabase, and Tailwind CSS. It provides a robust authentication system and a sleek user interface for storing and managing sensitive information.
Features
- Bank-Grade Security: AES-256-GCM encryption with master/data key hierarchy and automatic key rotation.
- Project Workspaces: Organize secrets into distinct projects for better management.
- Semantic Routing: Clean, GitHub-style URLs (
/[username]/[project-slug]) for easy sharing and navigation. - Team Collaboration: Secure project sharing with strict Role-Based Access Control:
- Owner: Full administrative control (Rename, Delete, Manage Team).
- Editor: Active contributor (Read/Write secrets, request to Share).
- Viewer: Read-only access to variables.
- Secure Authentication: Powered by Supabase Auth for robust user management, including Passkey support for passwordless, biometric login.
- Modern UI/UX: Built with Tailwind CSS, Shadcn UI, and Framer Motion for a premium experience.
- Interactive 3D Elements: High-performance 3D visuals powered by React Three Fiber.
- Keyboard First: Navigate efficiently with fully customizable, conflict-free hotkeys.
- Responsive Design: Fully responsive layout that works seamlessly on desktop and mobile.
- Dark Mode Support: Built-in support for light and dark themes.
- CLI Support: Manage your secrets directly from your terminal, featuring automatic non-blocking background update checks.
- Native Vercel Integration: Link Vercel projects, map environments, and sync secrets directly into Vercel env storage for serverless runtime compatibility.
- Real-time System Status: Monitor system health, active incidents, and historical uptime with a dedicated status page.
- Dedicated Support Page: Integrated support features directly within the app to help users manage troubleshooting options efficiently.
- Comprehensive Documentation: Integrated docs site with guides, API reference, and CLI documentation.
CLI
Envault natively supports the Model Context Protocol (MCP), so AI coding assistants like Claude Desktop, Cursor, and RooCode/Cline can pull and push your secure environments effortlessly.
# Automatically configure your AI clients (Global & Local Workspaces)
envault mcp install
# Or install strictly for the current workspace
envault mcp install --local
Installation
macOS & Linux (Universal)
curl -fsSL https://raw.githubusercontent.com/DinanathDash/Envault/main/install.sh | sh
macOS (Homebrew)
brew tap DinanathDash/envault
brew install --formula envault
Homebrew cask installs are deprecated. If you installed via cask, migrate with:
brew uninstall --cask dinanathdash/envault/envault
brew install --formula envault
For more details, check out the CLI Documentation.
Local Testing
Envault local development now uses portless with HTTPS hostnames.
npm install -g portless
To use the Envault CLI with the local development server, set the ENVAULT_CLI_URL environment variable:
export ENVAULT_CLI_URL="https://envault.localhost:1355/api/cli"
envault login
For one-command envault run local app startup, prefer hosted API fetch-first behavior by not setting ENVAULT_CLI_URL/ENVAULT_BASE_URL.
Security Architecture
Envault uses a hybrid encryption model to ensure maximum security:
- Master Key: A 32-byte key stored in environment variables, used solely to encrypt/decrypt Data Keys.
- Data Keys: Unique keys for encrypting actual data. These are stored encrypted in the database.
- Key Rotation: Data keys can be rotated. The active key is cached in Redis for high performance without compromising security.
- AES-256-GCM: Industry-standard authenticated encryption for all secrets.
Tech Stack
- Framework: Next.js (App Router)
- Database & Auth: Supabase
- KV Store: Upstash Redis
- Documentation: Fumadocs
- Styling: Tailwind CSS
- UI Components: Shadcn UI / Radix UI
- 3D & Graphics: React Three Fiber / Three.js
- Animations: Framer Motion
- Icons: Lucide React
- State Management: Zustand
- Forms: React Hook Form + Zod
- Notifications: Sonner
- Analytics: Vercel Analytics
Getting Started
Follow these steps to get the project running locally.
Prerequisites
- Node.js 18+ installed
- A Supabase project set up
Installation
-
Clone the repository
git clone https://github.com/dinanathdash/envault.git cd envault -
Install dependencies
npm install # or yarn install # or pnpm install # or bun install -
Environment Setup
Copy the example environment file:
cp .env.example .env.localOpen
.env.localand add your Supabase credentials:NEXT_PUBLIC_SUPABASE_URL=your-project-url NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key # Generate a secure key: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))" ENCRYPTION_KEY=your-64-char-hex-key SUPABASE_SERVICE_ROLE_KEY=your-service-role-key UPSTASH_REDIS_REST_URL=your-upstash-url UPSTASH_REDIS_REST_TOKEN=your-upstash-token # Used for securely signing and verifying frontend API mutations (POST, PUT, DELETE, PATCH) NEXT_PUBLIC_API_SIGNATURE_SALT=your-secure-random-hmac-secret -
Run the development server
npm run devOpen https://envault.localhost:1355 with your browser to see the result.
Optional: Native Vercel Integration Setup
If you plan to use native Vercel sync (recommended for Vercel serverless runtimes), add these variables:
VERCEL_CLIENT_ID=your_vercel_oauth_client_id
VERCEL_CLIENT_SECRET=your_vercel_oauth_client_secret
VERCEL_REDIRECT_URI=https://your-domain.com/api/integrations/vercel/callback
VERCEL_WEBHOOK_SECRET=your_vercel_webhook_signing_secret
NEXT_PUBLIC_VERCEL_INTEGRATION_INSTALL_URL=https://vercel.com/<team-or-user>/~/integrations/envault
Use production URLs in production. Do not use ngrok or localhost callback URLs outside local development.
-
Test Email Configuration (Optional)
To verify that your Resend API configuration is working, you can send a test email to yourself:
npm run test:email -- your-email@example.com
Monorepo Setup Map
This repository contains multiple publishable/runtime components. Use this map when cloning and contributing.
| Folder | Purpose | Install | Common Commands |
|---|---|---|---|
./ |
Main Next.js app | npm install |
npm run dev, npm run build, npm run lint, npm run test:all |
cli-go/ |
Go CLI (envault) |
go mod download |
go test ./..., go build ./... |
src/lib/sdk/ |
npm SDK package (@dinanathdash/envault-sdk) |
npm install |
npm run typecheck, npm run build |
mcp-server/ |
npm MCP package (@dinanathdash/envault-mcp-server) |
npm install |
npm run check, npm start |
cli-wrapper/ |
npm wrapper for CLI install/bootstrap | npm install |
node install.js |
First-time contributor flow
- Clone and install root dependencies:
git clone https://github.com/dinanathdash/envault.git
cd envault
npm install
- Copy env file and configure required keys:
cp .env.example .env.local
- Install package-local dependencies for publishable subpackages:
cd src/lib/sdk && npm install
cd ../../.. && cd mcp-server && npm install
cd ..
- Validate everything in one pass:
npm run lint
npm run test:all
npm run build
Package Publishing + Workflows
npm packages
- SDK:
@dinanathdash/envault-sdk(source:src/lib/sdk/) - MCP:
@dinanathdash/envault-mcp-server(source:mcp-server/)
GitHub Actions workflows
- CLI release workflow:
.github/workflows/publish.yml - SDK publish workflow:
.github/workflows/publish-sdk.yml - MCP publish workflow:
.github/workflows/publish-mcp.yml
Each package versions independently via semantic-release when changes occur in its own folder:
- CLI tags:
v<version> - SDK tags:
sdk-v<version> - MCP tags:
mcp-v<version>
This keeps SDK and MCP release streams decoupled from CLI version bumps.
Local prepublish checks
npm run sdk:check
npm run mcp:check
Manual publish commands
npm run sdk:publish
npm run mcp:publish
Version and Update Commands
Use these commands so users can quickly verify what version they are on and update safely.
CLI (envault)
Check installed CLI version:
envault --version
Update via Homebrew formula:
brew update
brew untap dinanathdash/envault || true
brew tap dinanathdash/envault
brew upgrade --formula envault
SDK (@dinanathdash/envault-sdk)
Check installed and latest SDK versions:
npm ls @dinanathdash/envault-sdk
npm view @dinanathdash/envault-sdk version
Update SDK (preferred via Envault CLI):
envault sdk update
Update SDK (npm fallback):
npm install @dinanathdash/envault-sdk@latest
Runtime behavior:
- SDK prints a warning when a newer SDK version exists.
- SDK blocks execution when below minimum supported version configured by server.
MCP (@dinanathdash/envault-mcp-server)
Check installed MCP version (standalone MCP package installs):
envault-mcp-server --version
Check MCP update availability (standalone MCP package installs):
envault-mcp-server --check-update
Update MCP integration (preferred via Envault CLI):
envault mcp update
Update MCP globally (npm fallback for standalone installs):
npm install -g @dinanathdash/envault-mcp-server@latest
License
Copyright (c) 2026 Dinanath Dash. All Rights Reserved.
The repository root source code is provided strictly for transparency, security auditing, and education. This is not open-source software.
You may inspect and analyze the code for security purposes. You may not execute, compile, run, deploy, copy, modify, fork, redistribute, sublicense, or provide any service using proprietary repository code without prior explicit written permission.
License scope exception: mcp-server/ and src/lib/sdk/ are distributed under MIT licenses in their respective directories.
See the LICENSE file for the complete legal terms.
Envault MCP questions
How do I add Envault MCP to Claude Code?
Run claude mcp add --env 'ENVAULT_TOKEN=<YOUR_ENVAULT_TOKEN>' --env 'ENVAULT_BASE_URL=<ENVAULT_BASE_URL>' envault -- npx -y @dinanathdash/envault-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Envault MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I use Envault with AI coding assistants?
You can use the Envault CLI to automatically configure AI clients like Claude Desktop, Cursor, and RooCode/Cline to manage your secure environments.
How do I install the Envault CLI on macOS?
You can install it via Homebrew using the DinanathDash/envault tap.