MCPgee
MCPgee
MCPgeeMCPgee

Witsy

v1.0.0•Developer Tools•stable

Witsy: desktop AI assistant / universal MCP client

anthropicdeepseekelectron-appelectronjsgemini
Share:
1,971
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Witsy?

Witsy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to witsy: desktop ai assistant / universal mcp client

Witsy: desktop AI assistant / universal MCP client

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Witsy: desktop AI assistant / universal MCP client

Use Cases

Desktop AI assistant with universal MCP client
Support for multiple models: Claude, Gemini, DeepSeek
Kochava-Studios

Maintainer

LicenseAGPL-3.0
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx witsy

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Witsy

Witsy is a desktop AI assistant and universal MCP client built as an Electron app that lets you use virtually any LLM — Claude, GPT-4, Gemini, DeepSeek, Groq, Ollama, and many more — through a single interface with a consistent keyboard shortcut. It supports image generation, speech-to-text, RAG over local files, real-time voice mode, and acts as an MCP client that can connect to any MCP server you configure, extending its capabilities with external tools. Developers and power users who work across multiple AI providers choose Witsy to avoid switching between apps while getting unified access to both conversation and automation workflows.

Prerequisites

  • macOS, Windows, or Linux desktop environment
  • API keys for the AI providers you want to use (OpenAI, Anthropic, Google, etc.) — Witsy is BYOK (Bring Your Own Keys)
  • Node.js 18+ if building from source
  • Optional: Ollama installed locally for offline model support
1

Install Witsy

Install the Witsy desktop app via Homebrew on macOS, or download the installer for Windows and Linux from the GitHub releases page. After first launch, the CLI tool is auto-installed at /usr/local/bin/witsy.

# macOS via Homebrew
brew install --cask witsy

# Or build from source
git clone https://github.com/Kochava-Studios/witsy.git
cd witsy && npm ci && npm start
2

Add your API keys

Open Witsy preferences and enter the API keys for the providers you want to use. At minimum add one chat provider key (e.g., ANTHROPIC_API_KEY for Claude). Witsy stores keys locally — they are never sent to any Witsy servers.

3

Configure MCP servers in Witsy

Navigate to the MCP Servers section in Witsy settings. Add MCP server definitions using the same JSON format used by Claude Desktop. Witsy will launch and connect to each configured server.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/Documents"]
    }
  }
}
4

Use the global keyboard shortcut to invoke Witsy

Set a global hotkey in Witsy preferences (e.g., Cmd+Shift+Space on macOS). Press it from any application to open Witsy's floating chat window. Use the Prompt Anywhere feature to send selected text or the clipboard directly to an AI.

# HTTP API also available for automation
curl "http://localhost:8090/api/chat?text=Hello%20World"
5

Enable optional capabilities (speech, RAG, image generation)

Add API keys for speech services (OpenAI Whisper, ElevenLabs), image providers (DALL-E, Replicate, fal.ai), or search engines (Tavily, Brave) to unlock those features within the same Witsy interface.

Witsy Examples

Client configuration

Witsy itself acts as an MCP client. To use Witsy's HTTP API from another tool, or to configure an MCP server within Witsy, use this format in Witsy's MCP settings panel.

{
  "mcpServers": {
    "witsy-mcp": {
      "command": "npx",
      "args": ["witsy"]
    }
  }
}

Prompts to try

Example tasks well-suited to Witsy's multi-provider and MCP-connected capabilities.

- "Generate an image of a futuristic city skyline at sunset"
- "Transcribe this audio file and summarize the meeting notes"
- "Search the web for the latest news about MCP servers and give me a summary"
- "Read the files in my Documents folder and find all TODO items"

Troubleshooting Witsy

MCP server tools are not appearing in the chat interface

Go to Witsy settings > MCP Servers and verify the server JSON is valid. Click the refresh button to reconnect. Check that the command (e.g., npx) is accessible from the PATH Witsy uses, which may differ from your shell's PATH.

Global hotkey conflicts with another application

Open Witsy preferences and reassign the keyboard shortcut to a different key combination that is not in use by other apps. Avoid shortcuts that macOS or Windows reserves at the system level.

API calls fail with authentication errors after entering keys

Ensure the API key is pasted without leading or trailing spaces. Verify the key is for the correct provider and has sufficient credits or quota on the provider's dashboard.

Frequently Asked Questions about Witsy

What is Witsy?

Witsy is a Model Context Protocol (MCP) server that witsy: desktop ai assistant / universal mcp client It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Witsy?

Follow the installation instructions on the Witsy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Witsy?

Witsy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Witsy free to use?

Yes, Witsy is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Witsy Alternatives — Similar Developer Tools Servers

Looking for alternatives to Witsy? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "witsy": { "command": "npx", "args": ["-y", "witsy"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Witsy?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides