ollama-handoff
About
Offload cheap work from your AI agent to a local Ollama model — summaries, drafts, extractions, first-pass reviews — at zero cloud cost.
Details
- Author
- michael-whitecapdata
- Categories
- Developer Tools, AI, Automation
Jump to
Setup
Install ollama-handoff in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/michael-whitecapdata/ollama-handoff
Follow the installation instructions in the repository README, then restart your MCP client.
An MCP server that offloads cheap work from your cloud LLM agent to a local Ollama model.
Your frontier model (Claude, GPT, etc.) is brilliant and metered. A lot of the work it gets handed — summarizing a log, drafting a commit message, pulling every URL out of a file, a quick first-pass code review —doesn't need frontier reasoning at all.ollama-handoffexposes your localOllamainstance as a handful of purpose-builtMCPtools, so your agent can route that work to a model onyour own GPU— atzero cloud cost— and spend its (paid) reasoning budget on the things that actually need it.
This isn't a generic "wrap the Ollama API" server. Each tool ships with abaked-in system promptand adescription written for the calling agent, so the agent knowswhento hand off and gets a tuned result back without re-stating instructions every call.
- 💸Spend less.Routine offloads run locally and bill nothing.
- ⚡Keep the big model focused.Summaries, extractions, and drafts don't eat its context or your budget.
- 🧠Tuned, not raw.summarize_local,code_review_local,draft_commit_message_local, andextract_localcome with reviewer/summarizer/extractor system prompts already dialed in.
- 🔌Drop-in.One MCP registration; works with Claude Code, Claude Desktop, Cursor, and any MCP client.
- 🪶Tiny & auditable.Two dependencies (mcp,httpx), fully typed, unit-tested, no telemetry.
The fastest path isuv— no manual venv needed:
uvx ollama-handoff # run directly # or pip install ollama-handoff # then run: ollama-handoff
claude mcp add ollama-handoff -- uvx ollama-handoff
Claude Desktop / Cursor (mcpconfig block)
{ "mcpServers": { "ollama-handoff": { "command": "uvx", "args": ["ollama-handoff"], "env": { "OLLAMA_DEFAULT_MODEL": "qwen2.5-coder:14b" } } } }
docker build -t ollama-handoff . docker run --rm -i -e OLLAMA_URL=http://host.docker.internal:11434 ollama-handoff
On native Linux (no Docker Desktop), use--network=hostwithOLLAMA_URL=http://localhost:11434.
All configuration is via environment variables set in your MCP registration:
Once registered, you don't call the tools yourself — your agent does. A typical exchange:
You:Summarize the errors inbuild.logand draft a commit for the staged fix.
Agent:(callssummarize_local(build.log, focus="errors and stack traces")anddraft_commit_message_local(git diff --staged)— both run on your GPU, nothing billed)→ returns the summary + commit message.
git clone https://github.com/Michael-WhiteCapData/ollama-handoff cd ollama-handoff uv pip install -e ".[dev]" ruff check . pytest # tests use httpx.MockTransport — no running Ollama required
SeeCONTRIBUTING.md. Contributions welcome — especially new specialized handoff tools.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
Equip AI agents with evaluation and self-improvement capabilities with Root Signals.
MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.
True deliberative consensus MCP server where AI models debate and refine positions across multiple rounds
Local agent workbench bundling OpenHands, Goose, Aider, and ashlrcode against one local LLM, with ashlr-plugin MCP servers pre-wired.
Free AI prompt orchestration with 185 expert roles, 1,741 templates, and 4 MCP tools — no API key required
Unified MCP server providing access to Claude Code, Codex, and Gemini CLIs through a single gateway. Features multi-LLM orchestration, persistent session management, async job execution with polling, approval gates, retry with circuit breakers, and token optimization. Install: npx -y llm-cli-gateway
a complete and intuitive SDK for building MCP Servers, MCP Agents, and LLM integrations (OpenAI, Claude, Gemini) with minimal effort. It abstracts all the complexity of the MCP protocol, provides an intelligent agent with automatic model routing, and includes a universal client for external APIs all through a single, simple, and powerful interface. Perfect for chatbots, enterprise automation, internal system integrations, and rapid development of MCP-based ecosystems.
Intelligent orchestration platform that routes tasks to the best AI model (Claude, Codex, Gemini, OpenCode) using LinUCB bandits, validates through consensus voting, and learns from outcomes. 29 MCP tools, dev pipeline, 8 memory backends.
Dynamically manage AI personas from markdown files for AI assistants like Claude.
The first EU-sovereign, version-controlled prompt library that natively exposes your team’s templates as a managed MCP Server for agentic discovery.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
