Claude Code MCP Server enables running Claude Code CLI in one-shot mode with automatic permission bypass. It provides a unified `claude_code` tool that lets AI assistants offload complex, multi-step file operations and coding tasks to Claude Code. Key features: - Execute Claude Code with permissions automatically bypassed using `--dangerously-skip-permissions` - Handle complex, multi-step file edits and operations that other AI editors struggle with - Queue multiple commands for efficient context management and reduced compactions - Direct file editing and git operations without permission interruptions - Customizable Claude CLI binary via `CLAUDE_CLI_NAME` environment variable - Cost-effective offloading of file operations and git tasks to avoid using expensive models - Works with Claude Desktop, Cursor, Windsurf, and other MCP clients

Claude Code MCP Server

[](https://www.npmjs.com/package/@steipete/claude-code-mcp) [](/CHANGELOG.md)

An MCP (Model Context Protocol) server that allows running Claude Code in one-shot mode with permissions bypassed automatically.

Did you notice that Cursor sometimes struggles with complex, multi-step edits or operations? This server, with its powerful unified claude_code tool, aims to make Claude a more direct and capable agent for your coding tasks.

Overview

This MCP server provides one tool that can be used by LLMs to interact with Claude Code. When integrated with Claude Desktop or other MCP clients, it allows LLMs to:

Benefits

Prerequisites

Configuration

Environment Variables

Installation & Usage

The recommended way to use this server is by installing it by using npx.

    "claude-code-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/claude-code-mcp@latest"
      ]
    },

To use a custom Claude CLI binary name, you can specify the environment variable:

    "claude-code-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@steipete/claude-code-mcp@latest"
      ],
      "env": {
        "CLAUDE_CLI_NAME": "claude-custom"
      }
    },

Important First-Time Setup: Accepting Permissions

Before the MCP server can successfully use the claude_code tool, you must first run the Claude CLI manually once with the --dangerously-skip-permissions flag, login and accept the terms.

This is a one-time requirement by the Claude CLI.

npm install -g @anthropic-ai/claude-code

claude --dangerously-skip-permissions

Follow the prompts to accept. Once this is done, the MCP server will be able to use the flag non-interactively.

macOS might ask for all kind of folder permissions the first time the tool runs and the first run then fails. Subsequent runs will work.

Connecting to Your MCP Client

After setting up the server, you need to configure your MCP client (like Cursor or others that use mcp.json or mcp_config.json).

MCP Configuration File

The configuration is typically done in a JSON file. The name and location can vary depending on your client.

#### Cursor

Cursor uses mcp.json.

#### Windsurf

Windsurf users use mcp_config.json

(Note: In s