Ambient

A shared memory for the people and AI agents in a company. Meetings, work sessions and notes become a wiki that stays current on its own, and every AI app your team uses (Claude, ChatGPT, Microsoft Copilot, Claude Code, Codex) reads and writes it over MCP.

Ambient Cloud · Self-host · Architecture · Configuration · Security

Agents are only as good as their context. Every agent in a company should know what the other agents and the people did and decided, and a company wiki only works if something keeps it current. Ambient does both: it turns what happens at work into wiki pages (people, projects, topics, decisions), keeps them up to date with Claude, and serves them to any AI app over MCP.

This repository is Ambient's server: the MCP gateway, the personal and team wikis, the Claude Code plugin and the routine runner. The iPhone and Mac apps that record meetings are separate.

✨ Features

• One MCP server for every AI app. OAuth 2.1 with dynamic client registration for Claude, ChatGPT and other MCP clients; personal access tokens for the rest. Tools: index, search, fetch, brief, get_entity, list_recent, list_decisions, list_action_items, transcript, save_note and log_work.

• Personal wikis, encrypted at rest. Each user's pages are sealed with their own data key (AES-256-GCM) before they reach the database. The key that wraps those keys never leaves the gateway.

• Team wikis in git. Each team's wiki is a git repository on the team's own server: plain markdown with front matter, one commit per change. Connect your own GitHub or GitLab repo and the wiki stays in step with it, both ways.

• Work sessions become notes. The Claude Code plugin sends finished sessions; the gateway cuts them down, strips anything that looks like a secret, and Claude writes a short note. Folder rules route sessions to a team after a 30-minute hold.

• Wikis that keep themselves current. Every night Claude folds the day's notes into the living pages (people, projects, topics), files decisions and writes an overview. It also checks for broken links, orphans and stale pages.

• Routines. Prompts that Claude Code runs on a schedule on your own machines, with secrets, run history and live progress, managed from any AI app.

• Search that understands German and English: SQLite FTS5 with umlaut folding and trigram matching.

Related MCP server: tela

📦 Deploy Ambient

Ambient Cloud

The fastest way: install the app, sign in with Apple or Microsoft, and connect your AI apps. No servers. Personal wikis are free; teams get a managed team server in Germany. See ambientartifacts.si.

Self-host Ambient

Run the whole server on one Linux machine with Docker. It's free and MIT licensed; you bring the machine and, for Claude's upkeep, an Anthropic API key.

git clone https://github.com/Ambient-Artifacts/ambient-core.git ambient && cd ambient
ops/docker/init.sh ambient.example.com      # or --local to try it at http://localhost:8080
docker compose exec gateway admin user add you@example.com --name "Your Name"
docker compose exec gateway admin connect-code you@example.com

Then add https://ambient.example.com/mcp as a connector in Claude (Settings → Connectors) and type the code. In the iPhone or Mac app, Use your own server on the sign-in screen connects it to your server. The self-hosting guide covers DNS, the apps, teams, Claude Code, backups and upgrades.

🔌 Connect your AI apps

🏗️ How it's built

AI apps ──MCP──▶ gateway ──▶ Convex (users, teams, tokens, encrypted personal pages)
iPhone/Mac ────▶    │
Claude Code ───▶    └──signed 60 s tokens──▶ team server (git wiki, search, nightly upkeep)

More in docs/architecture.md.

🧑‍💻 Develop

Node 24.

npm install
npm test             # the gateway tests run against the real Convex functions (convex-test) and real team servers
npm run typecheck
npm run schemas      # regenerate spec/json-schema/*.json
cd control && CONVEX_AGENT_MODE=anonymous npx convex dev   # a local Convex backend, no account needed

🤝 Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md first: it covers the setup, the tests, the three lines of "why" every change carries, and the sign-off (DCO).

🔒 Security and privacy

• Note text is readable only on the user's devices, in the gateway's memory and on the team's own server. Convex stores personal pages encrypted.

• Team servers accept only 60-second tokens signed by the gateway.

• An AI app's token is bound to one URL, so a token for /t/<team>/mcp can't read personal notes, and team membership is checked on every request.

• Report vulnerabilities privately: see SECURITY.md.

Telemetry: this code sends none. Self-hosted Convex has an anonymous usage ping, which the compose file turns off (CONVEX_DISABLE_BEACON=true). The only outside services a self-hosted server calls are the ones you configure: Anthropic, your git host, your alert webhook.

🥇 License and trademarks

The code is MIT licensed. The license doesn't cover the Ambient name or logo: if you run a modified version as a service for others, give it a different name.