cor-mcp

MCP (Model Context Protocol) server for the COR project management platform.

Exposes COR's REST API as MCP tools so any compatible AI assistant (Claude Desktop, Claude Code, Cursor, Windsurf, etc.) can manage projects, tasks, hours, clients, teams, and users using natural language.

Setup

1. Install dependencies

npm install

2. Configure authentication

Copy the example env file:

cp env.example .env

Option A — Client credentials (recommended for CI/automation):

Edit .env and add your API key and client secret:

COR_API_KEY=your_api_key_here
COR_CLIENT_SECRET=your_client_secret_here

Get these from COR: Settings → Integrations → API. The server will automatically obtain a Bearer token on startup using the OAuth2 client_credentials flow and refresh it when it expires.

Option B — Interactive login:

Leave COR_API_KEY / COR_CLIENT_SECRET unset. After connecting the MCP server, call cor_login with your email and password:

cor_login(email: "you@company.com", password: "...")

The access token is stored in memory for the current session. You'll need to call cor_login again each time the server restarts.

3. Build

npm run build

4. Configure your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cor": {
      "command": "node",
      "args": ["/absolute/path/to/cor-mcp/dist/index.js"]
    }
  }
}

Claude Code

claude mcp add cor -- node /absolute/path/to/cor-mcp/dist/index.js

Cursor / Windsurf / VS Code (Cline)

Add to your MCP config:

{
  "mcpServers": {
    "cor": {
      "command": "node",
      "args": ["/absolute/path/to/cor-mcp/dist/index.js"]
    }
  }
}

Related MCP server: Rytnow MCP Server

Available Tools

Authentication

Projects

Tasks

Hours

Clients

Teams

Users

Reference Values

Task status: nueva · en_proceso · estancada · finalizada

Task priority: 0 = Low · 1 = Medium · 2 = High · 3 = Urgent

Project status: in_process · finished · suspended

Project health: 1 = On track · 2 = At risk · 3 = Delayed · 4 = Critical

Development

Run without building (uses tsx):

npm run dev