Agent skill

Add Ollama Tool

by sbusso in sbusso/claudeclaw

Add Ollama MCP server so the container agent can call local models for cheaper/faster tasks like summarization, translation, or general queries.

MITAuto-check: notesAI & LLM Engineering

Install Add Ollama Tool

skills CLI
$ npx skills add sbusso/claudeclaw --skill add-ollama-tool -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sbusso/claudeclaw add-ollama-tool --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sbusso/claudeclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/add-ollama-tool .claude/skills/add-ollama-tool && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-ollama-tool
GitHub stars
194
Token cost
~1.1k tokens
SKILL.md length
478 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Add Ollama MCP server so the container agent can call local models for cheaper/faster tasks like summarization, translation, or general queries.

  • Works in 4 steps: Pre-flight → Apply Code Changes → Configure → …
  • Tasks that involve LLM inference and serving
  • SKILL.md covers Phase 1: Pre-flight, Phase 2: Apply Code Changes, Phase 3: Configure and Phase 4: Verify, plus 1 more section
  • Calls git, ollama and npm

What it does

Add Ollama Tool is an agent skill from sbusso/claudeclaw. Add Ollama MCP server so the container agent can call local models for cheaper/faster tasks like summarization, translation, or general queries.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering LLM inference and serving. It works with Ollama and Model Context Protocol. The repository describes itself as: Use Claude to orchestrate agents like OpenClaw. The licence is MIT.

When your agent uses it

  • Tasks that involve LLM inference and serving

Example prompts

  • “/add-ollama-tool”

Requirements

  • Docker

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Pre-flight
  2. Apply Code Changes
  3. Configure
  4. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 1395af4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • ollama
    • npm
    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • ollama.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Ollama Tool loads about 1.1k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 478 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:94
    t`. To use a custom Ollama host, add to `.env`:
  • NoteMentions a .env fileSKILL.md:151
    g a custom host, check `OLLAMA_HOST` in `.env`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sbusso/claudeclaw at commit 1395af4, republished under its MIT licence (© sbusso). 478 words, ~1,128 tokens.

Download SKILL.mdSave it as .claude/skills/add-ollama-tool/SKILL.md (or your agent's skills folder).
name
add-ollama-tool
description
Add Ollama MCP server so the container agent can call local models for cheaper/faster tasks like summarization, translation, or general queries.

Add Ollama Integration

This skill adds a stdio-based MCP server that exposes local Ollama models as tools for the container agent. Claude remains the orchestrator but can offload work to local models.

Tools added:

  • ollama_list_models — lists installed Ollama models
  • ollama_generate — sends a prompt to a specified model and returns the response

Phase 1: Pre-flight

Check if already applied

Check if agent/runner/src/ollama-mcp-stdio.ts exists. If it does, skip to Phase 3 (Configure).

Check prerequisites

Verify Ollama is installed and running on the host:

bash
ollama list

If Ollama is not installed, direct the user to https://ollama.com/download.

If no models are installed, suggest pulling one:

You need at least one model. I recommend:

bash
ollama pull gemma3:1b    # Small, fast (1GB)
ollama pull llama3.2     # Good general purpose (2GB)
ollama pull qwen3-coder:30b  # Best for code tasks (18GB)

Phase 2: Apply Code Changes

Ensure upstream remote
bash
git remote -v

If upstream is missing, add it:

bash
git remote add upstream https://github.com/sbusso/claudeclaw.git
Merge the skill branch
bash
git fetch upstream skill/ollama-tool
git merge upstream/skill/ollama-tool

This merges in:

  • agent/runner/src/ollama-mcp-stdio.ts (Ollama MCP server)
  • scripts/ollama-watch.sh (macOS notification watcher)
  • Ollama MCP config in agent/runner/src/index.ts (allowedTools + mcpServers)
  • [OLLAMA] log surfacing in src/orchestrator/container-runner.ts
  • OLLAMA_HOST in .env.example

If the merge reports conflicts, resolve them by reading the conflicted files and understanding the intent of both sides.

Copy to per-group agent-runner

Existing groups have a cached copy of the agent-runner source. Copy the new files:

bash
for dir in data/sessions/*/agent-runner-src; do
  cp agent/runner/src/ollama-mcp-stdio.ts "$dir/"
  cp agent/runner/src/index.ts "$dir/"
done
Validate code changes
bash
npm run build
./src/runtimes/docker/build.sh

Build must be clean before proceeding.

Phase 3: Configure

Set Ollama host (optional)

By default, the MCP server connects to http://host.docker.internal:11434 (Docker Desktop) with a fallback to localhost. To use a custom Ollama host, add to .env:

bash
OLLAMA_HOST=http://your-ollama-host:11434

Service name: Derived from the directory name: com.claudeclaw.<dirname> (macOS) / claudeclaw-<dirname> (Linux). For example, if cwd is my-assistant, the service is com.claudeclaw.my-assistant. Determine the correct service name before running service commands below.

Restart the service
bash
launchctl kickstart -k gui/$(id -u)/com.claudeclaw  # macOS
# Linux: systemctl --user restart claudeclaw

Phase 4: Verify

Show full SKILL.md (191 more words)Show less
Test via WhatsApp

Tell the user:

Send a message like: "use ollama to tell me the capital of France"

The agent should use ollama_list_models to find available models, then ollama_generate to get a response.

Monitor activity (optional)

Run the watcher script for macOS notifications when Ollama is used:

bash
./scripts/ollama-watch.sh
Check logs if needed
bash
tail -f logs/claudeclaw.log | grep -i ollama

Look for:

  • Agent output: ... Ollama ... — agent used Ollama successfully
  • [OLLAMA] >>> Generating — generation started (if log surfacing works)
  • [OLLAMA] <<< Done — generation completed

Troubleshooting

Agent says "Ollama is not installed"

The agent is trying to run ollama CLI inside the container instead of using the MCP tools. This means:

  1. The MCP server wasn't registered — check agent/runner/src/index.ts has the ollama entry in mcpServers
  2. The per-group source wasn't updated — re-copy files (see Phase 2)
  3. The container wasn't rebuilt — run ./src/runtimes/docker/build.sh
"Failed to connect to Ollama"
  1. Verify Ollama is running: ollama list
  2. Check Docker can reach the host: docker run --rm curlimages/curl curl -s http://host.docker.internal:11434/api/tags
  3. If using a custom host, check OLLAMA_HOST in .env
Agent doesn't use Ollama tools

The agent may not know about the tools. Try being explicit: "use the ollama_generate tool with gemma3:1b to answer: ..."

© sbusso, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/add-ollama-tool of sbusso/claudeclaw.

Open the folder on GitHubat commit 1395af4

Compare with similar skills

Add Ollama Tool next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Ollama Tool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Ollama Tool this skillsbusso/claudeclaw194—~1.1kAutomated safety check: NotesMIT
Perfupraullenchai/Rapid-MLX4k—~1.6kAutomated safety check: NotesCustom licence
Integrate Modeltryonlabs/opentryon551—~1.1kAutomated safety check: PassCustom licence
Agent Frameworkjihadkhawaja/Egroo178—~1.9kAutomated safety check: PassApache-2.0
Mesh APImr-tbot/mesh-api180—~1.8kAutomated safety check: PassGPL-3.0
Facturasgustavoeenriquez/MakerAi212—~127Automated safety check: PassMIT

Similar skills

  • Perfup

    raullenchai/Rapid-MLX

    Autonomous performance optimization: research, PoC, benchmark, implement, review, PR

    4k GitHub stars~1.6k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes
  • Integrate Model

    tryonlabs/opentryon

    Integrates a hosted API or local/open-weight model end-to-end across OpenTryOn (adapter, CLI registry, MCP, docs) and TryOn Studio (catalog, Connect keys, planner).

    551 GitHub stars~1.1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Agent Framework

    jihadkhawaja/Egroo

    Build, extend, and debug AI agents in Egroo using the Microsoft Agent Framework (C .NET).

    178 GitHub stars~1.9k tokensUpdated 6 mo ago
    AI & LLM EngineeringAuto-check passed
  • Mesh API

    mr-tbot/mesh-api

    Interact with a Meshtastic LoRa mesh network through MESH-API — list nodes, read messages, send texts, and check connection status.

    180 GitHub stars~1.8k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Facturas

    gustavoeenriquez/MakerAi

    Úsalo cuando el usuario pida redactar una factura, una cuenta de cobro o una nota de cobro.

    212 GitHub stars~127 tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Configuring Agent Brain

    SpillwaveSolutions/agent-brain

    Installation and configuration skill for Agent Brain document search system.

    119 GitHub stars~7k tokensUpdated 21 days ago
    AI & LLM EngineeringAuto-check: notes

More from sbusso/claudeclaw

All 23 skills in this repo
  • Debug

    sbusso/claudeclaw

    Debug container agent issues. An agent skill from sbusso/claudeclaw.

    194 GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check: notes
  • X Integration

    sbusso/claudeclaw

    X (Twitter) integration for ClaudeClaw. An agent skill from sbusso/claudeclaw.

    194 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check: notes
  • Add Gmail

    sbusso/claudeclaw

    Add Gmail integration to ClaudeClaw. An agent skill from sbusso/claudeclaw.

    194 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Add Qmd

    sbusso/claudeclaw

    Add QMD (Query Markup Documents) as an advanced memory search backend.

    194 GitHub stars~629 tokensUpdated 1 mo ago
    Auto-check passed
  • Add Telegram

    sbusso/claudeclaw

    Add Telegram as a channel. An agent skill from sbusso/claudeclaw.

    194 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check: notes
  • Add Telegram Swarm

    sbusso/claudeclaw

    Add Agent Swarm (Teams) support to Telegram. An agent skill from sbusso/claudeclaw.

    194 GitHub stars~3.7k tokensUpdated 1 mo ago
    Auto-check: notes

Questions about Add Ollama Tool

What does Add Ollama Tool do?

Add Ollama MCP server so the container agent can call local models for cheaper/faster tasks like summarization, translation, or general queries. Add Ollama Tool is an agent skill from sbusso/claudeclaw. Add Ollama MCP server so the container agent can call local models for cheaper/faster tasks like summarization, translation, or general queries.

When should I use Add Ollama Tool?

Add Ollama Tool fits situations like: tasks that involve LLM inference and serving.

How do I install Add Ollama Tool in Claude Code?

Run `npx skills add sbusso/claudeclaw --skill add-ollama-tool -a claude-code`. Or copy the skill folder (skills/add-ollama-tool in sbusso/claudeclaw) into .claude/skills/add-ollama-tool in your project. Claude Code loads it when a task matches its description.

How do I install Add Ollama Tool in Codex?

Run `npx skills add sbusso/claudeclaw --skill add-ollama-tool -a codex`. Or copy the skill folder (skills/add-ollama-tool in sbusso/claudeclaw) into .agents/skills/add-ollama-tool in your project. Codex loads it when a task matches its description.

Can I use Add Ollama Tool in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sbusso/claudeclaw --skill add-ollama-tool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-ollama-tool, .gemini/skills/add-ollama-tool, .github/skills/add-ollama-tool and .opencode/skills/add-ollama-tool in your project.

What does Add Ollama Tool need to run?

Going by SKILL.md and its folder, Add Ollama Tool needs the command-line tools its instructions call (git, ollama, npm and docker). Our summary lists: Docker.

Does Add Ollama Tool access the network?

SKILL.md names 1 domain. As links in the text: ollama.com. This is read from the text; nothing was executed.

Is Add Ollama Tool safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Add Ollama Tool use?

Add Ollama Tool is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Ollama Tool use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Ollama Tool?

Skills that share tags, products or a category with Add Ollama Tool: Perfup (raullenchai/Rapid-MLX, 4k stars), Integrate Model (tryonlabs/opentryon, 551 stars), Agent Framework (jihadkhawaja/Egroo, 178 stars) and Mesh API (mr-tbot/mesh-api, 180 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Ollama Tool?

sbusso (a GitHub user) maintains it in sbusso/claudeclaw, which has 194 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on August 12, 2026.

Source: sbusso/claudeclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.