y0mcp

Control your dev projects from Slack using your claude.ai subscription.

Multi-project routing. Permission relay. Always-on with auto token refresh. No API key required — works with claude.ai Pro/Max.

Why y0mcp

| | OpenClaw | Claude Code Channels | y0mcp | |---|---|---|---| | Slack | ✓ | ✗ | ✓ | | Multi-project routing | ✓ | ✗ | ✓ | | Permission relay in Slack | ✗ | ✗ | ✓ | | claude.ai subscription | ✗ | ✓ | ✓ | | API key required | ✓ | ✗ | ✗ | | Auto token refresh | ✗ | ✗ | ✓ | | Always-on (launchd/systemd) | ✗ | ✗ | ✓ | | Container logs (Dozzle) | ✗ | ✗ | ✓ |

How it works

You → Slack #project-a → y0mcp → Claude Code in ~/projects/project-a
                               ↕ permission relay (✅/❌ in Slack)
                               → Dozzle API (optional)

Quick Start

1. Add marketplace and install plugin — in Claude Code terminal:

/plugin marketplace add es-ua/y0mcp
/plugin install slack@y0mcp

2. Create a Slack App — see Setup Slack App

3. Create an agent:

bash scripts/new-agent.sh

4. Start:

# Mac
launchctl load ~/Library/LaunchAgents/dev.y0mcp.my-project.plist

# Linux
systemctl --user enable --now y0mcp-my-project

5. Pair — message the bot in Slack → get code → /pair CODE in terminal

Permission relay

🔴 Permission required

Action: `rm -rf ./node_modules`
Reason: Cleaning before reinstall

React ✅ to approve or ❌ to deny (timeout: 5 min)

Always-on

Agents start automatically on login
Auto-restart on crash (KeepAlive)
OAuth token refreshed every 2 hours

Multiple projects

Each agent is independent — separate Slack channel, separate repo, separate process. Run as many as you need. Token refresh uses file locking to prevent conflicts.

Requirements

macOS or Linux
Claude Code CLI (claude.ai login)
claude.ai Pro or Max subscription
Slack workspace (admin access to create apps)

Security

Socket Mode — no public URL exposed
Pairing — only you can message the agent
Permission relay — approve/deny risky actions from Slack
Token refresh under file lock — no race conditions

Project structure

y0mcp/
├── plugins/slack/       ← Slack channel plugin (v1)
├── scripts/             ← Install, token refresh, agent setup
├── docs/                ← Documentation
└── site/                ← y0mcp.dev (Astro Starlight)

Roadmap

v1: Slack + permission relay + always-on ← now
v2: Hosted mcp.y0mcp.dev — connect agents to cloud, API keys, subscriptions

License

MIT

MCP Servers