Mcp Aider Executor
Spins up Aider as a detached background process so your LLM can kick off code editing tasks and check back later on progress. The server creates tracking files including process details, chat history, and the original prompt, then exposes tools to monitor git status, read chat logs, and verify if Aider is still running. Requires whitelisting specific directories via glob patterns for safety. Also includes basic git tools for branch switching, stashing, and reverting commits, plus file reading capabilities. The architecture lets you build agentic workflows where one LLM delegates coding work to Aider instances and polls their markdown chat history files to see what got done. Needs Node, Aider, and git installed locally, and you configure your LLM backend through environment variables pointing to OpenAI compatible endpoints.
- tools
- 14
- transport
- STDIO
- last updated
- May 15, 2026
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
aider_check_git_logChecks recent commits.
Checks recent commits.
No parameter schema in public metadata yet.
aider_check_git_statusCalls `git status --short` to check the state of the given directory.
Calls `git status --short` to check the state of the given directory.
No parameter schema in public metadata yet.
aider_check_last_promptReturns the original prompt message of the last Aider run.
Returns the original prompt message of the last Aider run.
No parameter schema in public metadata yet.
aider_check_progressChecks the Aider chat history and background process status.
Checks the Aider chat history and background process status.
No parameter schema in public metadata yet.
aider_checkout_git_branchSwitches git branches, creating a new one if it doesn't exist.
Switches git branches, creating a new one if it doesn't exist.
No parameter schema in public metadata yet.
aider_create_git_stashStashes everything to clear the directory for Aider (`git stash -u`).
Stashes everything to clear the directory for Aider (`git stash -u`).
No parameter schema in public metadata yet.
aider_git_revertReverts changes from a git commit by its hash.
Reverts changes from a git commit by its hash.
No parameter schema in public metadata yet.
aider_list_filesLists all files in a given directory.
Lists all files in a given directory.
No parameter schema in public metadata yet.
aider_list_git_branchesReturns a list of git branches in the given directory.
Returns a list of git branches in the given directory.
No parameter schema in public metadata yet.
aider_mcp_check_whitelistChecks what glob paths are whitelisted for this Aider MCP server.
Checks what glob paths are whitelisted for this Aider MCP server.
No parameter schema in public metadata yet.
aider_message_promptStarts `aider` as a background process with a given message prompt.
Starts `aider` as a background process with a given message prompt.
No parameter schema in public metadata yet.
aider_read_config_yamlReturns the full content of the .aider.conf.yml in the directory.
Returns the full content of the .aider.conf.yml in the directory.
No parameter schema in public metadata yet.
aider_read_file_contentsReads the contents of a given filepath.
Reads the contents of a given filepath.
No parameter schema in public metadata yet.
aider_setup_config_yamlCreates the .aider.conf.yml file in the directory.
Creates the .aider.conf.yml file in the directory.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Project Information
stdio MCP server to run aider as a detached background process
with basic git tools and status checks. This allows LLMs to start code editing processes
freely and check the aider chat history for progress at a later time to allow for agentic swarm behavior.
An .aider.mcp.details.json file is created in the same directory with the process ID and starting datetime.
The MCP server provides tools for LLM agents to check if the process is still running,
and to check the .aider.chat.history.md for updates.
The original message prompt send via the MCP server to aider is also recorded in .aider.mcp.prompt.txt.
Quick Start
You can run the server directly using npx, passing in environment variables for the endpoint URL and API keys.
Provide --whitelist arguments with a permitted glob path otherwise all operations will be denied by default.
Details
- Repository
- github.com/railkill/mcp-aider-executor
- Package
mcp-aider-executor- Transport
- STDIO
- Registry
- MCP registry, active