MCP server for AI CLI tools (Claude, Codex, and Gemini) with background process management
MCP server for AI CLI tools (Claude, Codex, and Gemini) with background process management
An MCP (Model Context Protocol) server that allows running AI CLI tools (Claude, Codex, Gemini, Forge, and OpenCode) in background processes with automatic permission handling.
This MCP server provides tools that can be used by LLMs to interact with AI CLI tools. When integrated with MCP clients, it allows LLMs to:
The only prerequisite is that the AI CLI tools you want to use are locally installed and correctly configured. - Claude Code: claude doctor passes, and execution with --dangerously-skip-permissions is approved (you must run it manually once to login and accept terms). - Codex CLI (Optional): Installed and initial setup (login etc.) completed. - Gemini CLI (Optional): Installed and
Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| ai-cli-mcp | MCP server entrypoint |
| ai-cli | human-facing CLI for background AI runs |
| run | ps |
| result | peek |
| wait | kill |
| cleanup | doctor |
| models | mcp |
| peek | Starts a one-shot short observation window for running child agents and returns structured events observed during that specific call. By default this includes only natural-language message events; pass include_tool_calls |
| list_processes | Lists all running and completed AI agent processes with their status, PID, and basic info. |
| doctor | Checks supported AI CLI binary availability and path resolution from MCP clients. Like ai-cli doctor, it returns a checks block and does not verify login state or terms acceptance. |
| get_result | Gets the current output and status of an AI agent process by PID. |
| kill_process |
{
"mcpServers": {
"ai-cli": {
"command": "npx",
"args": ["-y", "ai-cli-mcp"],
"env": {
"CLAUDE_CLI_NAME": "your-value",
"CODEX_CLI_NAME": "your-value",
"OPENCODE_CLI_NAME": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
The only prerequisite is that the AI CLI tools you want to use are locally installed and correctly configured. - Claude Code: claude doctor passes, and execution with --dangerously-skip-permissions is approved (you must run it manually once to login and accept terms). - Codex CLI (Optional): Installed and initial setup (login etc.) completed. - Gemini CLI (Optional): Installed and
| Variable | Description | Required |
|---|---|---|
| CLAUDE_CLI_NAME | Configuration value read at startup. | Optional |
| CODEX_CLI_NAME | Configuration value read at startup. | Optional |
| OPENCODE_CLI_NAME | Configuration value read at startup. | Optional |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Shell, Docker, metrics, keys and files — over one SSH connection per host. Unlocked with your fingerprint. Green on black, because that is how it should look.
An MCP (Model Context Protocol) server that gives AI assistants and agents read access to your Brightspace courses: due dates with real submission status, grades, assignments, rubrics, course…
Source-linked CodeGraph exploration, ranked search, and static navigation for coding agents.
A GitHub Action and a GitLab CI template ship from this repository too.