Allows for the management and monitoring of Syncthing file synchronization instances, providing capabilities to configure folders and devices, monitor system status and connectivity, and perform administrative actions such as rescanning folders or pausing synchronization.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Syncthing MCP ServerCheck the sync status of my 'Photos' folder and list any errors."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Syncthing MCP Server
A Model Context Protocol (MCP) server for managing and monitoring Syncthing file synchronization instances. Built with FastMCP.
Features
35 tools for complete Syncthing management
Multi-instance support - manage multiple Syncthing nodes from one server
Three transport modes - streamable-http, SSE, and stdio
Async throughout - non-blocking httpx client with connection pooling
Quick Start
git clone https://github.com/zaphodsdad/syncthing-mcp.git
cd syncthing-mcp
cp .env.example .env
# Edit .env with your Syncthing instance details
uv sync
uv run syncthing-mcpConfiguration
Single Instance
SYNCTHING_URL=http://localhost:8384
SYNCTHING_API_KEY=your-api-key-hereMultiple Instances
SYNCTHING_INSTANCES=server1|http://host1:8384|key1,server2|http://host2:8384|key2Server Options
SERVER_HOST=0.0.0.0
SERVER_PORT=8088
TRANSPORT=streamable-http # streamable-http, sse, or stdio
LOG_LEVEL=INFOTools
Monitoring (15 tools, read-only)
Tool | Description |
| List configured instances and check connectivity |
| System status: version, uptime, memory usage |
| Device connections with bandwidth and addresses |
| Sync completion % for a folder/device pair |
| All configured folders with labels, paths, types |
| Detailed folder sync state, file counts, errors |
| All configured devices with names and addresses |
| Per-device stats: last seen, connection duration |
| Per-folder stats: last scan, last synced file |
| Current system errors |
| Recent log entries (filterable by timestamp) |
| Devices requesting to connect |
| Folders offered by remote devices |
| Browse files/directories within a synced folder |
| Quick up/down health check (no auth required) |
Actions (8 tools)
Tool | Description |
| Trigger folder rescan (full or subfolder) |
| Pause syncing with a specific device |
| Resume syncing with a specific device |
| Pause all syncing |
| Resume all syncing |
| Force local state as authoritative (send-only folders) |
| Revert local changes to match remote (receive-only folders) |
| Clear system error log |
Configuration (12 tools)
Tool | Description |
| Add a new shared folder |
| Modify folder settings |
| Remove a shared folder (files on disk unchanged) |
| Add a new device by ID |
| Modify device settings |
| Remove a device |
| Accept a pending device connection |
| Reject a pending device connection |
| Accept a pending folder share |
| Reject a pending folder share |
| Get full config or a specific section |
| Restart the Syncthing service |
Client Configuration
Claude Desktop
{
"mcpServers": {
"syncthing": {
"command": "npx",
"args": ["-y", "@anthropic-ai/mcp-remote", "http://your-host:8088/mcp"]
}
}
}Claude Code
claude mcp add syncthing http://your-host:8088/mcpstdio mode
{
"mcpServers": {
"syncthing": {
"command": "uv",
"args": ["--directory", "/path/to/syncthing-mcp", "run", "syncthing-mcp"],
"env": {
"SYNCTHING_URL": "http://localhost:8384",
"SYNCTHING_API_KEY": "your-key",
"TRANSPORT": "stdio"
}
}
}
}Deployment (systemd)
sudo cp syncthing-mcp.service /etc/systemd/system/
sudo systemctl enable --now syncthing-mcpDevelopment
uv sync --dev
uv run pytest tests/ -v
uv run ruff check .
uv run ruff format --check .License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.