Skip to main content
Glama

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

Tool

Description

cor_login

Authenticate with email + password (stores token for the session)

Projects

Tool

Description

cor_list_projects

List projects (paginated, optional name search)

cor_get_project

Get project details by ID

cor_create_project

Create a new project

cor_update_project

Update an existing project

Tasks

Tool

Description

cor_list_tasks

List tasks (paginated, optional project filter)

cor_get_task

Get task details by ID

cor_create_task

Create a task within a project

cor_update_task

Update an existing task

Hours

Tool

Description

cor_list_hours

List logged hours (optional date filter)

cor_log_hours

Log worked hours to a task

Clients

Tool

Description

cor_list_clients

List clients (optional name search)

cor_get_client

Get client details by ID

Teams

Tool

Description

cor_list_teams

List all teams

cor_get_team

Get team details by ID

Users

Tool

Description

cor_list_users

List users (optional name search)

cor_get_user

Get user profile by ID


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

Available Tools

17 tools
cor_create_projectB

Crea un nuevo proyecto en COR. / Create a new project in COR. Requires a project name. Optionally assign a client and team.

Inputs: name (required), description, clientId, teamId, +2 more.

cor_create_taskB

Crea una nueva tarea en COR dentro de un proyecto. / Create a new task in COR within a project. Requires a name and projectId. Optionally set status, priority, assignee, and due date.

Inputs: name (required), projectId (required), description, status, +4 more.

cor_get_clientB

Obtiene los detalles de un cliente de COR por su ID. / Get COR client details by ID.

Inputs: id (required).

cor_get_projectA

Obtiene un proyecto de COR por su ID. / Get a COR project by its ID. Returns full project details including status, health, client, and team.

Inputs: id (required).

cor_get_taskA

Obtiene el detalle completo de una tarea de COR por su ID. / Get full details of a COR task by ID. Includes status, priority, assignees, hours, and more.

Inputs: id (required).

cor_get_teamA

Obtiene los detalles de un equipo de COR por su ID. / Get COR team details by ID. Includes team name and associated metadata.

Inputs: id (required).

cor_get_userB

Obtiene el perfil de un usuario de COR por su ID. / Get a COR user profile by ID.

Inputs: id (required).

cor_list_clientsA

Lista los clientes en COR. / List clients in COR. Returns all clients with their contact info. Optionally search by name.

Inputs: search, page, perPage.

cor_list_hoursA

Lista las horas registradas en COR. / List logged hours in COR. Can filter by a specific date. Returns time entries with task, project, and user info.

Inputs: date, page, perPage.

cor_list_projectsA

Lista los proyectos de COR con paginación. / List COR projects with pagination. Use this to browse all projects, optionally filter by name.

Inputs: page, perPage, search.

cor_list_tasksA

Lista las tareas en COR con paginación opcional. / List tasks in COR with optional pagination. Can filter by project ID to see tasks within a specific project.

Inputs: page, perPage, projectId.

cor_list_teamsA

Lista los equipos en COR. / List teams in COR. Returns all teams. Useful for finding the teamId needed when creating or filtering projects.

Inputs: page, perPage.

cor_list_usersA

Lista los usuarios en COR. / List users in COR. Returns team members. Optionally search by name. Useful for finding userId when assigning tasks.

Inputs: search, page, perPage.

cor_log_hoursB

Registra horas trabajadas en COR para una tarea. / Log worked hours in COR for a task. Requires taskId, hours, and date. Optionally add a description.

Inputs: taskId (required), hours (required), date (required), description.

cor_loginA

Authenticate with COR using email and password. Call this if COR_API_KEY + COR_CLIENT_SECRET are not configured. Stores the access token in memory for the current session.

Inputs: email (required), password (required).

cor_update_projectA

Actualiza un proyecto existente en COR. / Update an existing COR project. Only provide the fields you want to change.

Inputs: id (required), name, description, clientId, +3 more.

cor_update_taskA

Actualiza una tarea existente en COR. / Update an existing COR task. Only provide the fields you want to change. Useful for changing status, priority, assignee, etc.

Inputs: id (required), name, description, status, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 17 tools

    Disambiguation5/5

    Each tool targets a unique resource and action (e.g., cor_create_project, cor_list_hours, cor_login). No two tools have overlapping purposes, and the resource is clearly indicated in the name and description.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case and the cor_ prefix (e.g., cor_create_project, cor_list_users, cor_update_task). The verbs are standard CRUD and listing operations.

    Tool Count5/5

    17 tools is well-scoped for a project management and time tracking system. Each tool serves a distinct purpose, and the number is neither too few to be useful nor too many to be overwhelming.

    Completeness4/5

    The tool set covers core CRUD operations for projects and tasks (create, read, update, list), plus list/get for clients, teams, users, and logging hours. Missing delete operations and creation for clients/teams/users, but these are minor gaps for typical workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers