English Français العربية

io.github.Michael-WhiteCapData/ollama-handoff

Official registry AI and agents

Offload cheap work from your AI agent to a local Ollama model, at zero cloud cost.

Source code

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package ollama-handoff
Claude Code 
claude mcp add ollama-handoff -e 'OLLAMA_URL=http://localhost:11434' -e 'OLLAMA_DEFAULT_MODEL=qwen2.5-coder:14b' -e 'OLLAMA_NUM_CTX=32768' -e 'OLLAMA_KEEP_ALIVE=30m' -e 'OLLAMA_TIMEOUT_S=600' -- uvx ollama-handoff==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ollama-handoff": {
            "command": "uvx",
            "args": [
                "ollama-handoff==0.1.2"
            ],
            "env": {
                "OLLAMA_URL": "http://localhost:11434",
                "OLLAMA_DEFAULT_MODEL": "qwen2.5-coder:14b",
                "OLLAMA_NUM_CTX": "32768",
                "OLLAMA_KEEP_ALIVE": "30m",
                "OLLAMA_TIMEOUT_S": "600"
            }
        }
    }
}

Environment variables

  • OLLAMA_URL Base URL of the Ollama server.
  • OLLAMA_DEFAULT_MODEL Default model used for handoffs.
  • OLLAMA_NUM_CTX Context window in tokens.
  • OLLAMA_KEEP_ALIVE How long to keep the model resident in VRAM.
  • OLLAMA_TIMEOUT_S Per-request timeout in seconds.

Frequently asked questions

What is io.github.Michael-WhiteCapData/ollama-handoff?

Offload cheap work from your AI agent to a local Ollama model, at zero cloud cost.

How do I install io.github.Michael-WhiteCapData/ollama-handoff?

It runs on your machine. In Claude Code: claude mcp add ollama-handoff -e 'OLLAMA_URL=http://localhost:11434' -e 'OLLAMA_DEFAULT_MODEL=qwen2.5-coder:14b' -e 'OLLAMA_NUM_CTX=32768' -e 'OLLAMA_KEEP_ALIVE=30m' -e 'OLLAMA_TIMEOUT_S=600' -- uvx ollama-handoff==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Michael-WhiteCapData/ollama-handoff need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Michael-WhiteCapData/ollama-handoff open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Michael-WhiteCapData/ollama-handoff?

It is published by Michael-WhiteCapData. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.