# Duckduckgo MCP Server (MCP server)

> Duckduckgo MCP Server is an MCP server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing. It has 1,551 GitHub stars, is released under the MIT license and runs locally with uvx duckduckgo-mcp-server. It works with Claude Desktop, Claude Code, Cursor and VS Code.

A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/nickclyde/duckduckgo-mcp-server |
| GitHub stars | 1,551 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: duckduckgo-mcp-server |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | AI & search |
| Latest release | v0.7.0 (Sep 4, 2026) |
| Last commit | Sep 4, 2026 |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "command": "uvx",
      "args": [
        "duckduckgo-mcp-server"
      ],
      "env": {
        "DDG_SAFE_SEARCH": "your-value",
        "DDG_REGION": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env DDG_SAFE_SEARCH=your-value --env DDG_REGION=your-value --transport stdio duckduckgo-mcp-server -- uvx duckduckgo-mcp-server
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "duckduckgo-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "duckduckgo-mcp-server"
      ],
      "env": {
        "DDG_SAFE_SEARCH": "your-value",
        "DDG_REGION": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "duckduckgo-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "duckduckgo-mcp-server"
      ],
      "env": {
        "DDG_SAFE_SEARCH": "your-value",
        "DDG_REGION": "your-value"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `DDG_SAFE_SEARCH`: Shown in the README's example configuration.
- `DDG_REGION`: Shown in the README's example configuration.

## Tools

- `query`: Search query string
- `max_results`: Maximum number of results to return (default: 10)
- `region`: (Optional) Region/language code to override the default. Leave empty to use the configured default region.
- `us-en`: United States (English)
- `cn-zh`: China (Chinese)
- `jp-ja`: Japan (Japanese)
- `de-de`: Germany (German)
- `fr-fr`: France (French)
- `wt-wt`: No specific region
- `start_index`: Character offset to start reading from (for pagination)
- `max_length`: Maximum number of characters to return
- `backend`: Optional per-call override of the default fetch backend ("httpx", "curl", or "auto").
- `parse_mode`: Optional per-call extractor ("text", "main", or "markdown"). When omitted, uses DDGPARSEMODE / --parse-mode (default…
- `token`: A ref:// token exactly as it appeared in search results (the bare id also works)

## Similar MCP servers

- [MeiGen AI Design MCP](https://appsgit.com/mcp-servers/meigen-ai-design-mcp): Discover inspiration and create images and videos with the latest AI models. (1,788 stars, MIT)
- [Brave Search MCP Server](https://appsgit.com/mcp-servers/brave-search-mcp-server): Brave Search MCP Server: web results, images, videos, rich results, AI summaries, and more. (1,533 stars, MIT, official, needs API key)
- [Open WebSearch](https://appsgit.com/mcp-servers/open-websearch): Multi-engine MCP server, CLI, and local daemon for agent web search and content retrieval — skill-guided workflows, no API keys. (1,874 stars, Apache-2.0)
- [Open Ontologies](https://appsgit.com/mcp-servers/open-ontologies): Plan, apply and roll back changes to a production ontology, with a blast radius report and a proof an auditor can re-check. (1,386 stars, MIT)
- [Microsoft Learn MCP](https://appsgit.com/mcp-servers/microsoft-learn-mcp): Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs. (1,953 stars, CC-BY-4.0, official)
- [SearXNG Search](https://appsgit.com/mcp-servers/searxng-search): MCP server for SearXNG — privacy-respecting web search with pagination, URL reading. (1,329 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/duckduckgo-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.