Clearly — Claude Code MCP server: what it does, how to install
MCP server that connects agents to Clearly workspace documents, canvases, sheets, decks, projects and tickets.
MIT updated 2026-09-24
claude mcp add --transport http clearly https://relay.clearly.sh/mcpWhat Clearly does
Clearly runs as a remote server: your agent connects to https://relay.clearly.sh/mcp via OAuth 2.1, picks a workspace and agent at sign-in. Seven tools — clearly_catalog, clearly_read, clearly_write, clearly_edit, clearly_delete, clearly_grep, clearly_glob — let you read, edit, search and delete files inside the workspace.
Supports streamable HTTP and protocols 2026-07-28, 2025-06-18, 2025-03-26, 2024-11-05. To work with multiple workspaces at once, use /mcp/w/<workspaceId> — each path stores a separate credential. The beehaven CLI installs via curl -fsSL https://clearly.sh/install.sh | sh, needs Node 20+, and builds better-sqlite3 and node-pty for your platform.
The server is already deployed. No local dependencies, no Python, no FFmpeg.
What it helps with
- read a document or sheet from a Clearly workspace
- find all files mentioning a specific term
- create or edit a ticket, canvas or deck
- delete a file or project from the workspace
- work with two workspaces in one client
Example prompts for the agent
- Show me all documents in my Clearly workspace
- Find all tickets mentioning
pricing - Edit the
roadmapcanvas and add an entry for the 2.0 release
How to install Clearly
Platform CLI: remote server
claude mcp add --transport http clearly https://relay.clearly.sh/mcpPlatform CLI: remote server
codex mcp add clearly --url https://relay.clearly.sh/mcpConfig file
{
"mcpServers": {
"clearly": {
"url": "https://relay.clearly.sh/mcp"
}
}
}Config file
{
"servers": {
"clearly": {
"type": "http",
"url": "https://relay.clearly.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http clearly https://relay.clearly.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Clearly
How do I install Clearly in Claude Code?
Run claude mcp add --transport http clearly https://relay.clearly.sh/mcp, then claude mcp login clearly to complete OAuth sign-in.
What does Clearly do?
It connects your agent to a Clearly workspace: reads, edits, creates and deletes documents, sheets, canvases, decks, projects and tickets over MCP.
How can I work with multiple Clearly workspaces at once?
Add a server entry with the path /mcp/w/<workspaceId> for each workspace — the client will store a separate token for each entry.