confer
Click on "Deploy 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., "@conferSet up dinner with Sam next week."
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.
Confer
Open agent-to-agent coordination for personal AI assistants.
Your agent talks to your people's agents. You say "set up dinner with Sam next week"; your agent contacts Sam's agent, both check their own calendars privately, agree on a time, and each of you gets one message: "✅ Dinner is set for Tue 18:00." It works the same for a weekly game night with five friends or a book club with forty people.
Confer is an open-source, self-hostable take on the idea behind Instinct's Instinct-to-Instinct Trusted Person network. It isn't affiliated with Instinct and doesn't interoperate with it. Confer uses open standards (A2A v1.0 on the wire, MCP for your agent, iCalendar for calendars), so it works with any assistant: Claude, Hermes, Codex, OpenClaw, or your own.
Closed agent networks | Confer | |
Who runs the network | the vendor | you (a node per person; optional relays anyone can run) |
Who sees your calendar | the vendor's cloud | nobody. Your node only answers "which of these times work?" |
Message privacy | vendor policy | end-to-end encrypted + signed (NaCl), even through relays |
Which assistant | theirs | any agent that speaks MCP, or the CLI |
Protocol | proprietary | documented (docs/PROTOCOL.md), carried over A2A |
What it does
Trusted people only. Pair once with a one-time invite token. Strangers can't message your agent at all.
Per-person permissions (grants). Grants cover what each contact's agent may do with yours:
plans(propose plans),autoconfirm(plans that fit your calendar are accepted without asking you),files, andnotes.Private scheduling. The organizer's agent offers a few candidate times from its own free time. Your agent checks them against your calendar locally. You, or your
autoconfirmrule, say which ones work. The organizer's agent picks the earliest time that works for everyone and confirms it to all.Groups, quorum and recurring plans. A plan can need everyone or just N people (
--quorum 6). It can have a response deadline and an RRULE (FREQ=WEEKLY;BYDAY=TH). Counter-proposals and revisions are supported.End-to-end encrypted files and notes between agents (≤10 MB).
Works offline and behind NAT. A durable outbox retries messages for up to 7 days. A relay stores and forwards encrypted envelopes, and it can't read or forge them.
Your calendar in, your calendar out. Busy time comes from any
.icsfile or secret iCal URL (Google, iCloud, Outlook). Confirmed plans are written tocalendar.icsand served as a subscribable feed.Human in the loop. You get an inbox, plus webhook or command notifications (e.g. Telegram) for anything that needs you.
A phone inbox.
confer serveprints a private URL for a mobile-first page. From it you can approve plans and introductions, pick times, and dismiss items. It has no app, no JS framework and no external assets.
Things closed networks don't do
Vouched introductions.
confer introduce Sam Priyaoffers each of them the other's verified key, and each approves. Their agents then connect directly, with no token to pass around. Trust grows the way it does between people.Preference-weighted scheduling. You can mark the times you'd prefer (
--prefer 2), not just the ones that work. The group lands on the time most people like, not just the earliest one.Tentative holds. Times you've offered or accepted on an unresolved plan count as busy for other proposals. Two negotiations can't both claim your Friday.
Nudges. Organizers' agents remind people who haven't answered, once, in the last quarter before the deadline.
Agent Q&A.
confer note Sam "Thai or Italian?" --askreturns a message id, and the answer comes back threaded (reply_to). Your agent can ask Sam's agent things without interrupting either of you.Key rotation.
confer rotate-key --yesmoves you to a new key. The old key signs the handoff and the new key proves it is really held, so every contact follows automatically.
Related MCP server: Servicialo
Quick start
pip install "confer[ics,mcp] @ git+https://github.com/ryancalpin/confer" # or: uv tool install "confer[ics,mcp] @ git+https://github.com/ryancalpin/confer"
confer init "Alex" --tz America/Chicago
confer config endpoint https://alex.example.ts.net # where peers reach you (or: confer config relay <url>)
confer config calendar "https://calendar.google.com/calendar/ical/.../basic.ics"
confer serve --port 3067 & # put TLS in front (Tailscale Serve, Caddy, ...)
confer invite "Sam" # prints a one-time token — text it to Sam
# Sam runs: confer accept confer1:eyJ... --name AlexThen:
confer plan new "Dinner" --with Sam --duration 90 --from 2026-10-01 --to 2026-10-07 --between 18:00-21:00 --location "Luigi's"
confer inbox # Sam's side: "Alex wants to plan 'Dinner'... you're free for 1, 3"
confer plan respond <id> accept # Sam: accept the options their calendar shows free
confer plan list # both: [confirmed]More: confer grant Sam +autoconfirm, confer note Sam "Thai or Italian?",
confer send-file Sam menu.pdf, confer plan revise <id> --from ...,
confer plan cancel <id>, confer --json ... for scripts.
Use it from your AI assistant (MCP)
{ "mcpServers": { "confer": { "command": "confer", "args": ["mcp"] } } }Your agent gets 19 tools: confer_propose_plan, confer_inbox,
confer_respond, confer_send_note, confer_replies, confer_introduce,
confer_send_file, confer_invite, and others. Your agent is the brain: it understands "dinner with my wife on
Friday", books the restaurant, and texts you. Confer is the trusted pipe to
other people's agents. See examples/ for Claude Code and Hermes
config.
How it works
Alex's agent ──MCP──▶ Alex's node ══ A2A + signed, encrypted envelopes ══▶ Sam's node ◀──MCP── Sam's agent
│ (direct or via relay) │
alex.ics (busy) sam.ics (busy)Identity. Each node has an Ed25519 key, and its agent id is the public key. Pairing binds names to keys, so you can compare fingerprints out of band.
Envelopes. Every message is encrypted to the recipient (NaCl Box) and signed by the sender. Relays and proxies only see who is talking to whom.
Plans. The flow is hub-and-spoke: only the organizer's node can propose, revise, confirm or cancel. Participants don't need to know each other, and they never see each other's answers.
Full spec: docs/PROTOCOL.md. Threat model: SECURITY.md.
Running a node
confer serve --host 127.0.0.1 --port 3067puts a stdlib HTTP server on localhost. Expose it with TLS:tailscale serve/funnel, Caddy, nginx or Cloudflare Tunnel.If you can't expose anything, use a relay (
confer config relay https://relay.example). Your node then just polls the relay; runconfer serveanyway for the worker loop. To host a relay yourself for friends, runconfer relay --port 3068.Docker:
docker build -t confer . && docker run -v confer:/data -p 3067:3067 confer(rundocker run -it -v confer:/data confer init "Alex"once first).examples/confer.serviceis a systemd user unit.examples/notify-telegram.shpushes inbox events to your phone.State lives in
~/.confer/(or$CONFER_HOME):identity.key(0600),state.db,calendar.ics, and receivedfiles/. Back upidentity.key, because it is your identity.
Status
v0.2: the protocol and reference implementation are complete and tested (the end-to-end tests run real nodes over HTTP, with relays, retries, forged messages, introductions and key rotation). CI runs on Python 3.11–3.13. Not yet done: multi-device, CalDAV write-back, push instead of relay polling, and SDKs in other languages. Contributions welcome; see CONTRIBUTING.md.
License
Apache-2.0
This server cannot be deployed
Maintenance
Related MCP Connectors
End-to-end encrypted messaging and work coordination for autonomous AI agents.
- BasinOAuthco.getbasin
Your AI assistants coordinate with other people's in one shared library across tools and companies.
Matchmaking network for personal AI agents: private agent-to-agent compatibility rendezvous.
Marketplace for AI assistants to find collaborators and build peer-to-peer relationships
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables agentic coordination by connecting humans and AI agents through group messaging, project tracking, and milestone management. It provides tools for consensus voting, progress checkpoints, and multi-session collaboration across various agentic platforms.321MIT
- AlicenseAqualityAmaintenanceOpen protocol for AI-agent coordination of professional services. Scheduling, identity, delivery verification, and financial settlement across any vertical.1081 npm1Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI tools to discover, communicate with, and orchestrate AI agents over a decentralized peer-to-peer network with end-to-end encryption.6Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to network on behalf of users, handling profile management, intent-based matching, and secure messaging through the Model Context Protocol.23 npm1-