Aider MCP server: run Aider from your AI agent

Aider is a terminal coding assistant with no MCP support of its own. Community servers let another agent hand it coding tasks over MCP.

Checked 3 October 2026 · from The Aider repository, issue tracker and scripting docs, the three community repositories, npm, PyPI and the official MCP registry

One of 91 guides to monitoring and developer tools. Each covers what an AI coding agent can get out of the tool through MCP, the protocol that lets the agent query the tool directly.

How Aider works with MCP

Aider edits files in a local git repository from natural-language instructions. Its repository has 49,342 stars, and the latest release on PyPI is 0.86.2, from 12 February 2026.

Aider does not call MCP servers either. Pull request #5539, opened 8 August 2026, would add MCP client support and is still open.

An Aider MCP server lets one agent, such as Claude Code, delegate a coding task to Aider and its chosen model. The calling agent then reviews what Aider changed.

Every vendor here gets the same four checks: official, maintained, distributed and usable. Aider passes 1 of them.

Aider is a worker, not a data source. An agent hands it a task and reads the diff it commits. Nothing in Aider stores telemetry an agent would query.

What can an AI agent do with Aider?

How to configure Aider MCP for agents

1. 1

   Model keys

   Aider reads provider keys such as ANTHROPIC_API_KEY from its environment. Every wrapper passes them through, so the server holds your model credentials.

2. 2

   Working directory

   disler's server takes --current-working-dir; RailKill's takes --whitelist. Point both at one repository, not your home directory.

3. 3

   Model choice

   disler's README defaults to an experimental Gemini model ID from March 2025. Pass --editor-model explicitly.

Paste this into your agent’s instructions

When you delegate work to Aider, state:
- The instruction sent, the files named and the model Aider used.
- The commits Aider created, by hash.
Review the diff before reporting the task as done.
Do not merge Aider's commits without approval.

Do you need the MCP server at all?

Script Aider directly. Aider's docs describe --message, which runs one instruction, applies the edits and exits. An agent with a shell can do that without any MCP connection.

`disler/aider-mcp-server`. Two tools, aider_ai_code and list_models. It installs with uv sync from a lockfile that pins mcp 1.6.0 and aider-chat 0.81.0, so it does not pick up newer SDK changes.

`sengokudaikon/aider-mcp-server`. Six tools, including edit_files, create_files and git_status. It has 40 stars and a single day of commits, on 14 March 2025.

`RailKill/mcp-aider-executor`. Fourteen tools that run Aider as a detached process and poll aider_check_progress. It needs an import fix before it starts on a fresh install.

Call aider --message from the agent's shell. Use disler's server if your client cannot run shell commands.

Aider integration setup

The shell route needs only Aider installed and a model key in the environment. The MCP route below uses disler's server, which installs from its lockfile.

aider --message "add retries to the upload client" src/upload.py
git show --stat HEAD

claude mcp add-json "aider" '{"command":"uv",
  "args":["--directory","/path/to/aider-mcp-server",
          "run","aider-mcp-server",
          "--editor-model","<model>",
          "--current-working-dir","/path/to/your/repo"]}'

Every other client

Each block below is the configuration for one client, with the file path and the key that client expects.

// what 1.1.0 ships
import { McpServer, StdioServerTransport } from "@modelcontextprotocol/server";
// what stable 2.x expects
import { StdioServerTransport } from "@modelcontextprotocol/server/stdio";

What engineers report

Interest is high and still unmet in Aider itself. Issue #3314 has 24 comments since February 2025, and issue #4506 asks for a native MCP server. disler's wrapper, with 308 stars, is the one most engineers have tried.

Should you connect an agent to Aider?

Only if another agent should delegate coding work to Aider. Try scripting it with --message before adding a wrapper. Best for developers who already use Aider and want Claude Code or Cursor to hand it bounded tasks.

Strongest fit

Only if another agent should delegate coding work to Aider. Try scripting it with --message before adding a wrapper.

Main advantage

Aider can run a different, cheaper model than the calling agent for routine edits.

Main weakness

Every server is community-built, and none has been updated since May 2026.

Operational risk

Aider commits edits as it goes, so delegated work can land before anyone reviews it.

Frequently asked questions