Ollama MCP Server

Lightweight CLI client for a remote Ollama server

Local serverstdioPython

What is the Ollama MCP server?

Lightweight CLI client for a remote Ollama server. That is what the ollama mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

A lightweight CLI client for a remote Ollama server. Designed to be a drop-in replacement for the ollama CLI when you need to talk to a server running on a different machine — output formats, column names, and flag names match the official client character-for-character wherever possible.

Getting it running

Installation goes through your MCP client rather than a global install: point it at ollama-client on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

The tools it exposes

The server publishes 3 tools. What each one is for:

  • launch — Configure and launch an AI coding tool backed by the local Ollama server
  • help — The help tool exposed by this server
  • Divergencies — The official launch command includes a full TUI, model capability detection (vision, reasoning, context length), auto-install of integrations, cloud

What it needs from you

Configuration is passed through the environment: OLLAMA_HOST, OLLAMA_CLIENT_HOST, ANTHROPIC_BASE_URL, COPILOT_PROVIDER_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Ollama's toolset — launch, help, Divergencies — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
launchConfigure and launch an AI coding tool backed by the local Ollama server.
helpThe help tool exposed by this server.
DivergenciesThe official launch command includes a full TUI, model capability detection (vision, reasoning, context length), auto-install of integrations, cloud model support, and --yes auto-confirmation. This client implements the

How to install the Ollama MCP server

{
  "mcpServers": {
    "ollama-client": {
      "command": "uvx",
      "args": ["ollama-client"],
      "env": {
        "OLLAMA_HOST": "your-value",
        "OLLAMA_CLIENT_HOST": "your-value",
        "ANTHROPIC_BASE_URL": "your-value",
        "COPILOT_PROVIDER_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
OLLAMA_HOSTEndpoint or connection string the server talks to.Optional
OLLAMA_CLIENT_HOSTEndpoint or connection string the server talks to.Optional
ANTHROPIC_BASE_URLEndpoint or connection string the server talks to.Yes
COPILOT_PROVIDER_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Ollama to launch.
  • Use Ollama to help.
  • Use Ollama to Divergencies.

Frequently asked questions

It connects Ollama to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (launch, help, Divergencies) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Ollama directly.