MCP server to run Claude, Codex, and Gemini CLI agents in the background from any MCP client.

AI CLI MCP Server

🇯🇵 日本語のREADMEはこちら

📦 Package Migration Notice: This package was formerly @mkxultra/claude-code-mcp and has been renamed to ai-cli-mcp to reflect its expanded support for multiple AI CLI tools.

An MCP (Model Context Protocol) server that allows running AI CLI tools (Gemini, Codex, Gemini, Forge, and OpenCode) in background processes with automatic permission handling.

Did you notice that Gemini sometimes struggles with complex, multi-step edits or operations? This server, with its powerful unified run tool, enables multiple AI agents to handle your coding tasks more effectively.

Demo

Overview

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:

• Run Gemini CLI with all permissions bypassed (using --dangerously-skip-permissions)
• Execute Codex CLI with approvals and sandbox bypassed (using --dangerously-bypass-approvals-and-sandbox)
• Execute Gemini CLI with automatic approval mode (using -y)
• Execute Forge CLI in non-interactive mode (using forge -C <workFolder> -p <prompt>)
• Execute OpenCode in non-interactive JSON mode (using opencode run --format json --dir <workFolder> <prompt>)
• Support multiple AI models: Gemini (sonnet, sonnet[1m], opus, opusplan, haiku), Codex (gpt-5.4, gpt-5.3-codex, gpt-5.2-codex, gpt-5.1-codex-mini, gpt-5.1-codex-max, gpt-5.2, gpt-5.1, gpt-5.1-codex, gpt-5-codex, gpt-5-codex-mini, gpt-5), Gemini (gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview), Forge (forge), and OpenCode (opencode plus explicit `oc-<provider/model>