EnvMem

EnvMem

!EnvMem Hero

Your Environment Variables, Always at Hand

Personal environment variable memory with semantic search and project management. Multi-tenant MCP server that remembers all your API keys, secrets, and configurations.

 

Live: envmem.com | NPM: npmjs.com/package/envmem

!EnvMem Terminal

Features

• Semantic Search - Natural language queries powered by Cloudflare Vectorize
• Project Management - Organize envs by project with dev/staging/prod environments
• Auto-Fill .env - Parse .env.example and fill with your stored values
• Multi-Tenant Isolation - Each API key gets completely isolated storage
• MCP Protocol - Works with Claude, ChatGPT, and any MCP-compatible AI
• Service Bundles - Get all env vars for Stripe + Supabase + OpenAI in one query
• Edge-Native - Sub-50ms responses from 300+ global locations

---

🚀 Quick Start & MCP Configuration

EnvMem is designed to work seamlessly with any MCP-compatible client (like Claude Desktop, Cursor, or your own tools).

Option 1: Claude Desktop (Recommended)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "envmem": {
      "command": "npx",
      "args": ["-y", "envmem"],
      "env": {
        "ENVMEM_API_KEY": "your-secret-api-key"
      }
    }
  }
}

Note: Generate your API key at envmem.com or use any random string (it acts as your personal partition).

Option 2: Remote MCP (No Node.js required)

If your MCP client supports remote URLs (SSE), you can connect directly without running anything locally:

{
  "mcpServers": {
    "envmem": {
      "url": "https://envmem.com/mcp?apikey=your-secret-api-key"
    }
  }
}

---

Usage

1. Import Your Variables

import_env_variables({
  envText: `
    OPENAI_API_KEY=sk-...
    STRIPE_SECRET_KEY=sk_live_...
    DATABASE_URL=postgres://...
  `
})

2. Create a Project

create_project({
  name: "my-saas",
  repoUrl: "github.com/me/my-saas",
  tags: ["nextjs", "stripe", "supabase"]
})

3. Link Services to Project

link_services_to_project({
  projectName: "my-saas",
  services: ["Stripe", "Supabase", "OpenAI", "Clerk"]
})

4. Get Complete .env File

get_envs_for_project({
  projectName: "my-saas",
  environment: "prod"
})
// Returns ready-to-use .env file content

5. Auto-Fill from .env.example

fill_env_example({
  envExampleContent: `OPENAI_API_KEY=\nSTRIPE_SECRET_KEY=\nDATABASE_URL=`,
  projectName: "my-saas"
})
// Returns filled .env with your stored values

---

MCP Tools

Search & Retrieve

| Tool | Description | |------|-------------| | search_env_variables | Semantic + keyword search | | get_env_by_name | Get by exact name | | get_envs_for_services | Get all vars for services | | list_env_categories | List categories with counts |

Import & Manage

| Tool | Description | |------|-------------| | import_env_variables | Bulk import from .env text | | add_env_variable | Add single variable | | delete_env_variable | Delete by name | | clear_all_env_variables | Delete all (requires confirm) |

Project Management

| Tool | Description | |------|-------------| | create_project | Create project with repo URL + tags | | list_projects | List all your projects | | link_env_to_project | Link env to project (dev/staging/prod) | | link_services_to_project | Bulk link services to project | | get_envs_for_project | Get .env file for project | | fill_env_example | Auto-fill .env.example | | delete_project | Delete project + links |

---

Typical Workflow

// 1. Import your envs once
import_env_variables({ envText: "..." })

// 2. Create project
create_project({ name: "autoclient", repoUrl: "github.com/me/autoclient" })

// 3. Link services
link_services_to_project({
  projectName: "autoclient",
  services: ["Stripe", "Supabase", "OpenAI"]
})

// 4. Get .env for deployment
get_envs_for_project({ projectName: "autoclient", environment: "prod" })

---

Categories

| Category | Examples | |----------|----------| | ai_services | OpenAI, Anthropic, Google AI | | database | Supabase, PlanetScale, MongoDB | | payment | Stripe, PayPal, SumUp | | auth | Auth0, Clerk, Firebase | | email | SendGrid, Mailjet, Resend | | deployment | Vercel, Netlify, Railway | | storage | S3, Cloudflare R2, Cloudinary | | monitoring | Sentry, Datadog |

---

Authentication

Your API key creates isolated storage. Generate one:

openssl rand -hex 16

Pass via:

• Header: x-api-key: your-key
• Bearer: Authorization: Bearer your-key
• Query: ?apikey=your-key

---

Self-Hosting

git clone https://github.com/samihalawa/envmem-mcp.git
cd envmem-mcp
npm install

# Create Cloudflare resources
wrangler d1 create env-reference-db
wrangler vectorize create env-embeddings --dimensions=768 --metric=cosine

# Apply migrations
wrangler d1 migrations apply env-reference-db --remote

# Deploy
wrangler deploy

---

Tech Stack

• Runtime: Cloudflare Workers
• Embeddings: Workers AI (bge-base-en-v1.5, 768-dim)
• Vector Search: Cloudflare Vectorize
• Database: Cloudflare D1 (SQLite + FTS5)
• Protocol: MCP (Model Context Protocol)

---

License

ISC

Built with care for developers who forget their env var names.