- Mullvad VPN MCP Server
Mullvad VPN MCP Server
Overview
mullvad-mcp
Control Mullvad VPN from any MCP-compatible AI client — Claude Desktop, Cursor, Windsurf, and more.
All VPN interaction goes through the mullvad CLI. No API keys, no config file parsing, no credentials needed.
Prerequisites
- Mullvad VPN app installed with CLI in your PATH
- Python 3.11+
- uv package manager
Installation
git clone https://github.com/oregansamuel3/mullvad-mcp.git
cd mullvad-mcp
uv sync
Available Tools
Connection Control
connect— Connect to VPN, optionally specifying country/city/hostnamedisconnect— Disconnect from VPNreconnect— Reconnect, optionally to a new location
Status & Diagnostics
get_status— Current connection state, server, protocol, IPscheck_leak— Query am.i.mullvad.net to verify VPN protection
Server Selection
list_countries— All available countries with server countslist_cities— Cities for a given countrylist_servers— Servers with filters (country, city, owned_only)set_location— Set preferred location by country, city, or hostname
Account & Settings
get_account_info— Masked account number, expiry dateget_device_info— Devices registered to the accountget_settings— All current settings as a structured objectset_killswitch— Enable/disable lockdown modeset_daita— Enable/disable DAITA (traffic analysis defence)set_multihop— Enable/disable multihop with optional entry locationset_dns— Set DNS: default (with blocking options) or custom IPsset_protocol— Configure WireGuard optionsset_obfuscation— Set anti-censorship mode
Example Usage
"Connect me to Sweden" →
connect(country="se")
"Am I leaking?" →
check_leak()— queries am.i.mullvad.net
"Enable the kill switch and block ads" →
set_killswitch(enabled=True)+set_dns(block_ads=True)
Server Config
{
"mcpServers": {
"mullvad": {
"command": "uv",
"args": [
"--directory",
"/path/to/mullvad-mcp",
"run",
"mullvad-mcp"
]
}
}
}Project Info
Created At
4 days agoUpdated At
4 days agoAuthor Name
Samuel O'ReganStar
-Language
-License
-Recommend Servers
View AllSerper MCP Server
@garymengcom
A Serper MCP Server
Python
a year ago
Whitfield Advisory Internal Tools
21 hours ago
Agent Memory
@tverney
17 hours ago
Exergynet
@ezumba
2 days ago