About envibe
envibe-mcp is an MCP server that gives AI coding assistants permission-controlled access to environment variables. Its access levels determine what the AI can view or modify, while setup generates a manifest and filtered .env.ai file and blocks direct .env access.
Key features
- 01Five variable access levels
- 02List and retrieve permitted variables
- 03Set variables with full access
- 04Describe variable formats and examples
- 05Check missing required variables
- 06Block direct .env access
Use cases
- 01Limit an assistant's visibility of secrets
- 02Allow selected environment variables to be edited
- 03Guide setup of required variables
- 04Provide format hints for configuration
MCP support
envibe-mcp exposes tools for listing, reading, setting, and describing environment variables, and checking required variables. AI clients can connect to it through their MCP configuration.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
6Saved tool list · updated 2w ago
This tool takes no parameters.
Details
From the project READMEenvibe-mcp
MCP server for envibe - the missing permission layer between AI agents and your .env.
Install
Add to your AI tool's MCP config:
{
"mcpServers": {
"envibe": {
"command": "npx",
"args": ["envibe-mcp"]
}
}
}
Claude Code
claude mcp add envibe npx envibe-mcp
Claude Desktop
Add to claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
VS Code / Cursor / Windsurf
Add to your editor's MCP settings (see main envibe docs for details).
On first run, envibe automatically:
- Creates
.env.manifest.yamlfrom your.env.example - Generates
.env.ai(filtered view for AI) - Blocks direct
.envfile access
What is this?
This is the MCP server component of envibe. It gives AI coding assistants controlled access to your environment variables with 5 access levels:
| Level | AI Can See | AI Can Modify |
|---|---|---|
full | Actual value | Yes |
read-only | Actual value | No |
placeholder | <VAR_NAME> | No |
schema-only | Format only | No |
hidden | Nothing | No |
MCP Tools
| Tool | Description |
|---|---|
env_list | List visible variables with access levels |
env_get | Get a variable's value (respects permissions) |
env_set | Set a variable (only full access) |
env_describe | Get detailed info including format and example |
env_check_required | Check which required variables are missing |
v0.2.0 Features
- Better error messages - When access is denied, get helpful guidance
- Format hints - Know what format a variable should be (url, key, number, etc.)
- Required var checking - Use
env_check_requiredto guide users through setup
For CLI tools
If you need CLI commands like envibe setup -i (interactive mode), envibe view, or envibe generate, install the full package:
npm install -g envibe
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.