Clareo MCP Server 🚀

A powerful Model Context Protocol (MCP) server for the Clareo Ecosystem. Effortlessly manage your agency, projects, tasks, and notes directly from your favorite AI assistants (Claude Desktop, Cursor, VS Code, etc.).

Features

• 👔 Agency Management: List agencies and active members.
• 📋 Task Mastery: Create, list, and manage tasks with full support for projects, clients, and checklists.
• 📈 Performance Insights: Get aggregated agency reports or individual performance metrics.
• 📝 Smart Notes: Create private or agency-wide notes with pinning support.
• 🔐 Secure RBAC: Built-in access control via the Clareo Cloud Gateway.

Quick Start

1. Generate your API Key

Go to your Clareo Admin Dashboard > Settings > MCP Tokens and generate a new token.

2. Configure your Client

Add the following to your MCP settings file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "clareo": {
      "command": "npx",
      "args": ["-y", "clareo-mcp@latest"],
      "env": {
        "CLAREO_API_KEY": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Local Development (Contributors)

If you want to modify the server or run it locally:

1. Clone & Install:

   git clone https://github.com/prazerluizin/clareo-mcp.git
   cd clareo-mcp
   npm install

2. Environment Setup: Copy .env.example to .env and fill in your CLAREO_API_KEY.

3. Build & Run:

   npm run build
   node build/index.js

Documentation

• Tools Reference
• Architecture

License

ISC © Clareo