Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http clearly https://relay.clearly.sh/mcp
Open on GitHub

What 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 roadmap canvas 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/mcp

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open