Moco MCP

The MOCO MCP Server provides employees with read-only access to the MOCO API, supporting time tracking, project management, holiday tracking, and attendance monitoring. It includes 7 tools and 8 intelligent prompts.

Schedule management Developer tools #Time management #Project management #Holiday tracking #Attendance monitoring .TypeScript

rating : 2.5 points

downloads : 0

update time : 2025-09-09

Open Site

What is MOCO MCP Server?

MOCO MCP Server is an intelligent connector that allows you to securely access the data of the MOCO work management platform through AI assistants (such as Claude, Cursor, etc.). It provides read-only access, enabling you to query working hours, project progress, holiday balances, and attendance records without directly logging into the MOCO platform.

How to use MOCO MCP Server?

Simply configure it once in your preferred AI assistant application, and you can obtain MOCO data through natural language queries. For example, ask 'How many hours did I work this week?' or 'How many holidays do I still have available?' The AI assistant will automatically call the corresponding tools to provide you with answers.

Use cases

Suitable for professionals who need to frequently view working time statistics, manage project progress, plan holidays, or monitor team attendance. Particularly applicable to project managers, team members, and HR managers.

Main features

Time tracking analysis

Automatically summarize working hours by date, project, and task, and provide detailed daily and weekly reports.

Project management

View information on all assigned projects, search for specific projects, and obtain project task lists.

Holiday management

Query annual holiday balances, used holidays, and remaining days, and support intelligent holiday planning.

Attendance monitoring

View daily attendance times and statistical information, and analyze work patterns.

Sick leave tracking

Record and统计 annual sick leave situations, and provide an overview of health attendance.

Public holidays

Obtain the annual public holiday list and calculate the number of actual working days.

Intelligent prompts

8 AI-driven intelligent prompts that automatically combine multiple tools to provide comprehensive analysis.

Advantages

🔒 Secure read-only access - No MOCO data will be modified.

🤖 Intelligent integration - Interact with AI assistants through natural language.

📊 Automatic summarization - Automatically calculate time statistics and summarize data.

🌐 Multi-client support - Supports all mainstream MCP clients.

🔄 Real-time data - Connect directly to the MOCO API to obtain the latest information.

🎯 Scenario-based analysis - Provides in-depth analysis of work-life balance, productivity, etc.

Limitations

Requires MOCO API access permission.

Only provides read-only functionality and cannot create or modify data.

Relies on a stable network connection to access the MOCO API.

Requires a Node.js 18+ runtime environment.

How to use

Obtain MOCO API credentials

Configure the AI assistant

According to the AI assistant you are using (Claude, Cursor, etc.), add the MCP server settings to the configuration file.

Start using

Restart the AI assistant application. Now you can query MOCO data through natural language.

Usage examples

Weekly working time summary

Automatically generate a working time report for the previous week every Monday, including time allocation for each project and the total working hours.

Holiday planning assistant

Intelligently analyze the available holiday days when planning holidays, and avoid public holidays and project peak periods.

Project time analysis

Analyze the time investment in a specific project, and track project progress and resource allocation.

Frequently Asked Questions

What kind of MOCO account permissions do I need?

Will this server modify my MOCO data?

Which AI assistant applications are supported?

Is the data synchronized in real-time?

What should I do if I encounter an API authentication error?

Related resources

MOCO API official documentation

Complete API documentation and interface descriptions for the MOCO platform.

MCP protocol specification

Official specification and documentation for the Model Context Protocol.

GitHub project repository

Source code and issue tracking for the MOCO MCP Server.

Node.js download

Download the Node.js runtime environment (requires version 18.0.0 or higher).

🚀 📊 MOCO MCP Server

The MOCO MCP Server is a Model Context Protocol (MCP) server that offers employees read - only access to the MOCO API. It supports various functions such as time tracking, project management, holiday tracking, and presence monitoring.

🚀 Quick Start

npx -y @niondigital/moco-mcp

That's all! The server will start and be ready to connect to your MCP client.

✨ Features

✅ Read - only Access: Safe API integration with no data modification
🔄 Automatic Pagination: Handles large datasets seamlessly
📊 Smart Aggregation: Automatic summation by date, project, and task
🎯 Project Filtering: Filter activities by specific projects
🧩 Comprehensive Tools: 7 specialized tools for different use cases
🎯 Intelligent Prompts: 8 AI - powered prompts for complex analysis and insights
🌐 Multi - Client Support: Works with all major MCP clients

📦 Installation

Prerequisites

Node.js ≥ 18.0.0
MOCO account with API access
MOCO API key and subdomain

MCP Client Integration

Claude Desktop

Add to your Claude Desktop claude_desktop_config.json file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@niondigital/moco-mcp"],
      "env": {
        "MOCO_API_KEY": "your-moco-api-key",
        "MOCO_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Cursor

Add to your Cursor settings:

MacOS: ~/Library/Application Support/Cursor/User/settings.json
Windows: %APPDATA%\Cursor\User\settings.json
Linux: ~/.config/Cursor/User/settings.json

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@niondigital/moco-mcp"],
      "env": {
        "MOCO_API_KEY": "your-moco-api-key",
        "MOCO_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
   "mcpServers": {
      "moco": {
         "command": "npx",
         "args": ["-y", "@niondigital/moco-mcp"],
         "env": {
            "MOCO_API_KEY": "your-moco-api-key",
            "MOCO_SUBDOMAIN": "your-subdomain"
         }
      }
   }
}

Claude Code (CLI)

Add the MCP server to Claude Code:

claude mcp add -e MOCO_API_KEY="your-moco-api-key" -e MOCO_SUBDOMAIN="your-subdomain" moco -- npx -y @niondigital/moco-mcp

Gemini CLI

Configure Gemini CLI with MCP support:

{
   "mcpServers": {
      "moco": {
         "command": "npx",
         "args": ["-y", "@niondigital/moco-mcp"],
         "env": {
            "MOCO_API_KEY": "your-moco-api-key",
            "MOCO_SUBDOMAIN": "your-subdomain"
         }
      }
   }
}

Kiro

Go to Kiro > MCP Servers
Add new MCP server by clicking + Add
Paste the configuration below:

{
  "mcpServers": {
    "moco": {
    "command": "npx",
    "args": [
      "-y",
      "@niondigital/moco-mcp"
    ],
    "env": {
       "MOCO_API_KEY": "your-moco-api-key",
       "MOCO_SUBDOMAIN": "your-subdomain"
    },
    "disabled": false,
    "autoApprove": []
    }
  }
}

Click Save to apply changes

LM Studio

Go to Program (right side) > Install > Edit mcp.json
Paste the configuration below:

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@niondigital/moco-mcp"],
       "env": {
          "MOCO_API_KEY": "your-moco-api-key",
          "MOCO_SUBDOMAIN": "your-subdomain"
       }
    }
  }
}

Click Save to apply changes
Toggle MCP server on/off from the right hand side (under Program) or by clicking the plug icon at the bottom of the chat box

🔑 MOCO API Setup

Getting Your API Credentials

Log into your MOCO account
Navigate to API settings:
- Go to Profile → Integrations
- Or visit: https://niondigital.mocoapp.com/profile/integrations
Copy the listed API key
Note your subdomain:
- From your MOCO URL: https://yourcompany.mocoapp.com
- Your subdomain is: yourcompany

Environment Variables

You can set environment variables in several ways:

Option 1: System Environment Variables

export MOCO_API_KEY="your-moco-api-key"
export MOCO_SUBDOMAIN="your-subdomain"

Option 2: .env File (for local development)

MOCO_API_KEY=your-moco-api-key
MOCO_SUBDOMAIN=your-subdomain

Option 3: MCP Client Configuration (recommended) Use the env section in your MCP client configuration as shown above.

💻 Usage Examples

🛠️ Available Tools

Tool	Description	Parameters
`get_activities`	Get activities within a date range with summation and optional project filtering	`startDate`, `endDate` (ISO 8601), `projectId` (optional)
`get_user_projects`	List all assigned projects or search by query	`query` (optional)
`get_user_project_tasks`	Get all tasks for a specific assigned project	`projectId`
`get_user_holidays`	Get holiday overview for a year with calculations	`year`
`get_user_presences`	Get presence data within a date range with daily summaries	`startDate`, `endDate` (ISO 8601)
`get_user_sick_days`	Get sick days overview for a year with calculations	`year`
`get_public_holidays`	Get public holidays for a year with working days calculations	`year`

🎯 Available Prompts

The MoCo MCP server provides 8 intelligent prompts that orchestrate multiple tools to deliver comprehensive insights:

Prompt	Description	Key Parameters
`weekly_time_report`	Generates detailed weekly time tracking report with project breakdown	`week_start`, `include_billable_analysis`
`vacation_planning_assistant`	Assists with vacation planning by analyzing available days and holidays	`planned_start_date`, `planned_end_date`
`personal_productivity_insights`	Analyzes work habits and provides productivity recommendations	`analysis_period`, `focus_area`
`monthly_business_review`	Creates comprehensive business reports with trends and metrics	`month`, `year`, `include_comparisons`
`smart_work_life_balance_advisor`	Evaluates work-life balance with personalized recommendations	`analysis_weeks`, `target_hours_per_week`
`project_time_analysis`	Detailed project time analysis with efficiency metrics	`project_ids`, `time_period`
`team_capacity_overview`	Team capacity planning with absence and resource analysis	`planning_horizon`, `include_holidays`
`work_hours_compliance_check`	Compliance check for working time regulations	`check_period`, `max_weekly_hours`, `max_daily_hours`

Prompt Examples

Weekly Time Report

{
  "name": "weekly_time_report",
  "arguments": {
    "week_start": "2024-01-15",
    "include_billable_analysis": true
  }
}

Vacation Planning

{
  "name": "vacation_planning_assistant",
  "arguments": {
    "planned_start_date": "2024-07-15",
    "planned_end_date": "2024-07-29"
  }
}

Work - Life Balance Analysis

{
  "name": "smart_work_life_balance_advisor",
  "arguments": {
    "analysis_weeks": 6,
    "target_hours_per_week": 40
  }
}

Compliance Check

{
  "name": "work_hours_compliance_check",
  "arguments": {
    "check_period": "last_month",
    "max_weekly_hours": 48,
    "max_daily_hours": 10
  }
}

Tool Examples

Get Activities

Filter all activities in a date range:

{
  "name": "get_activities",
  "arguments": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31"
  }
}

Filter activities for a specific project:

{
  "name": "get_activities",
  "arguments": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-31",
    "projectId": 123456
  }
}

Sample Output:

Activities from 2024-01-01 to 2024-01-31:

2024-01-15:
  Project 123 (Website Redesign):
    Task 456 (Frontend Development): 4.5h (4:30)
    Task 789 (Backend API): 3.25h (3:15)
    Project total: 7.75h (7:45)
  Daily total: 7.75h (7:45)

Grand total: 7.75h (7:45)

Get User Projects

List all assigned projects:

{
  "name": "get_user_projects",
  "arguments": {}
}

Search projects:

{
  "name": "get_user_projects",
  "arguments": {
    "query": "website"
  }
}

Get User Project Tasks

{
  "name": "get_user_project_tasks",
  "arguments": {
    "projectId": 123456
  }
}

Get User Holidays

{
  "name": "get_user_holidays",
  "arguments": {
    "year": 2024
  }
}

Sample Output:

Holiday overview for 2024:

Taken holiday days:
- 2024-03-15: 1.0 day
- 2024-04-22: 0.5 day
- 2024-07-08: 1.0 day

Summary:
- Taken vacation: 2.5 days
- Annual entitlement: 25 days
- Utilization: 10% (2.5/25)
- Remaining vacation: 22.5 days

Get User Presences

{
  "name": "get_user_presences",
  "arguments": {
    "startDate": "2024-01-01",
    "endDate": "2024-01-07"
  }
}

Sample Output:

Presences from 2024-01-01 to 2024-01-07:

Daily presences:
- 2024-01-01: 8.25h (8:15)
- 2024-01-02: 7.5h (7:30)
- 2024-01-03: 8.0h (8:00)

Grand total: 23.75h (23:45)

Statistics:
- Working days: 3
- Average per day: 7.92h (7:55)

Get User Sick Days

{
  "name": "get_user_sick_days",
  "arguments": {
    "year": 2024
  }
}

Get Public Holidays

{
  "name": "get_public_holidays",
  "arguments": {
    "year": 2024
  }
}

Sample Output:

Public holidays for 2024:

Holiday dates:
- 2024-01-01: New Year's Day
- 2024-04-01: Good Friday
- 2024-04-03: Easter Monday
- 2024-05-01: Labor Day
- 2024-05-09: Ascension Day
- 2024-05-20: Whit Monday
- 2024-10-03: German Unity Day
- 2024-12-25: Christmas Day
- 2024-12-26: Boxing Day

Summary:
- Total public holidays: 9 days
- Approximate working days: 251 days

🔧 Advanced Configuration

Local Development

If you want to run from source:

git clone https://github.com/niondigital/moco-mcp.git
cd moco-mcp
npm install
npm run build
npm start

Then configure your MCP client to use the local path:

{
  "mcpServers": {
    "moco": {
      "command": "node",
      "args": ["/path/to/moco-mcp/dist/index.js"],
      "env": {
        "MOCO_API_KEY": "your-moco-api-key",
        "MOCO_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Docker Support

FROM node:18-alpine
WORKDIR /app
RUN npm install -g @niondigital/moco-mcp
ENV MOCO_API_KEY=""
ENV MOCO_SUBDOMAIN=""
CMD ["@niondigital/moco-mcp"]

🔍 Troubleshooting

Common Issues

❌ Authentication Error:

API authentication failed. Please check MOCO_API_KEY.

Verify your API key is correct and has necessary permissions
Check if the API key is properly set in environment variables
Ensure the key hasn't expired

❌ Subdomain Error:

MOCO_SUBDOMAIN should only contain the subdomain name

Use only the subdomain part: company (not company.mocoapp.com)
Remove https:// and .mocoapp.com from the subdomain

❌ Node.js Version Error:

This package requires Node.js >= 18.0.0

Update Node.js to version 18 or higher
Check your version: node --version

❌ npx Connection Issues:

Error: Cannot find module '@niondigital/moco-mcp'

Ensure you have internet connection
Try: npx --yes @niondigital/moco-mcp
Clear npx cache: npx clear-npx-cache

❌ MCP Client Not Finding Tools:

Restart your MCP client after configuration changes
Check that environment variables are properly set
Verify JSON configuration syntax is correct

Debug Mode

For debugging, you can run the server with additional logging:

NODE_ENV=development npx -y @niondigital/moco-mcp

Testing Connection

You can test the server manually:

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | npx -y @niondigital/moco-mcp

🤝 Contributing

Fork the repository
Create a feature branch: git checkout -b feature-name
Make your changes and add tests
Run tests: npm test
Submit a pull request

📄 License

MIT License - see LICENSE file for details.

🆘 Support

MOCO API Issues: MOCO API Documentation
MCP Protocol: MCP Documentation
This Package: GitHub Issues

Gitlab MCP Server

Certified

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

24.5K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

20.2K

5 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

TypeScript

14.8K

4.5 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご

Moco MCP

Overview

Installation

Tools List

Content Details

Alternatives

What is MOCO MCP Server?

How to use MOCO MCP Server?

Use cases

Main features

How to use

Usage examples

Frequently Asked Questions

Related resources

Installation

🚀 📊 MOCO MCP Server

🚀 Quick Start

✨ Features

📦 Installation

Prerequisites

MCP Client Integration

🔑 MOCO API Setup

Getting Your API Credentials

Environment Variables

💻 Usage Examples

🛠️ Available Tools

🎯 Available Prompts

Prompt Examples

Weekly Time Report

Vacation Planning

Work - Life Balance Analysis

Compliance Check

Tool Examples

Get Activities

Get User Projects

Get User Project Tasks

Get User Holidays

Get User Presences

Get User Sick Days

Get Public Holidays

🔧 Advanced Configuration

🔍 Troubleshooting

Common Issues

Debug Mode

Testing Connection

🤝 Contributing

📄 License

🆘 Support

Alternatives