Tether
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Tether
A self-hosted, single-user aggregator for email, calendars and tasks, with an MCP connector
for Claude. Tether pulls several Gmail inboxes into one triage list, merges calendars into one
hub calendar, turns mail into tasks and follow-ups, and lets Claude search mail and manage
tasks on your behalf. The design spec is the source of truth:
docs/initial_design_spec.md.
Layout
src/tether/: FastAPI app, service layer, connectors, pollers. SQLite schema inmigrations/.web/: React PWA (Vite). Built intoweb/dist, served by the same process.deploy/: build-and-install script, systemd unit, nginx site template.tests/:uv run pytest.
Related MCP server: calendar-tasks-mcp
Configuration
Everything site-specific lives in environment files, never in the repo:
File | Read by | Holds |
| the app, in development | secrets, OAuth client, owner identity, |
| the app, in production | the same variables, with production values |
|
|
|
You also need a Google Cloud OAuth client (Web application) with <TETHER_BASE_URL>/auth/google/callback
as an authorized redirect URI, and the Gmail and Calendar APIs enabled.
Develop
uv sync
cp .env.example .env # fill it in; see the comments
(cd web && npm install && npm run build)
uv run python -m tether serve --reloadOpen TETHER_BASE_URL (http://localhost:8000 by default). For frontend work, also run
npm run dev in web/ (port 5173, proxies the API to TETHER_PORT).
Always one worker. The pollers run inside the process; a second worker would duplicate
them. python -m tether serve always starts exactly one, so don't run uvicorn by hand with
--workers.
Connect Claude
In Claude, add a custom connector with the URL <TETHER_BASE_URL>/mcp. Claude registers itself,
then sends you through Tether's Google sign-in and a consent page. Only the owner can approve.
For Claude Code: claude mcp add --transport http tether <TETHER_BASE_URL>/mcp.
Deploy
Targets an Ubuntu server with Python 3.12+, nginx and certbot, reached over ssh with sudo.
Point a DNS record at the server.
On the server, create
/etc/tether/tether.envfrom.env.examplewith production values:TETHER_BASE_URL=https://<your domain>, a freeTETHER_PORT,TETHER_DB_PATH=/var/lib/tether/tether.dbandTETHER_STATIC_DIR=/opt/tether/web/dist.Locally,
cp deploy/.env.example deploy/.envand setTETHER_DEPLOY_HOST.Run
deploy/deploy.sh. It deploys only committed code, and records the revision in/opt/tether/REVISION.The first time only, add TLS:
sudo certbot --nginx -d <your domain> --redirect.
The app runs as its own tether system user. The database and env file are readable only by
that user, so other apps on the same server can't read them.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Every email and calendar account you connect, for AI agents, with permissions and approvals.
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
AI executive assistant: email triage, inbox, calendar, files, memory, phone and connected apps.
Let your AI agent read and act on your Mail, Calendar, Contacts and more. Works with iCloud.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Claude to manage Gmail, Google Calendar, and Google Drive, including sending emails, scheduling meetings, and organizing files, with integrated workflows.5MIT
- FlicenseAqualityBmaintenanceEnables Claude to manage Outlook calendar events and Microsoft To Do tasks for a specific mailbox via Microsoft Graph API.7-
- AlicenseBqualityCmaintenanceEnables Claude to interact with Apple apps on macOS including Mail, Calendar, Contacts, Reminders, Notes, and iCloud Drive for personal productivity tasks like triaging email, managing calendar, and cross-app context.769MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to access and manage multiple Google accounts at once across Gmail, Calendar, Drive, Contacts, and Tasks, with unified search and document text extraction.MIT