bitterpanda63/officient-mcp-server

Officient MCP Server

A Model Context Protocol (MCP) server for the Officient API, providing seamless integration with Claude and other MCP-compatible clients.

Features

This MCP server exposes 9 tools for interacting with the Officient API:

• list_people - Get a paginated list of people
• list_all_people - Get all people with automatic pagination
• get_person_detail - Get detailed information about a specific person
• get_employee_details - Get details of the current logged-in employee
• list_coworkers_days_off - Get coworkers' days off for a specific month
• list_own_days_off - Get your own days off for a specific year
• get_all_salary_slips - Get all salary slip files
• get_file_download_url - Get download URL for a file (e.g., salary slip PDF)
• get_vacation_day_budgets - Get vacation day budgets for a specific year

Installation

1. Clone this repository:

git clone https://github.com/bitterpanda63/officient-mcp-server.git
cd officient-mcp-server

2. Install dependencies:

npm install

3. Build the TypeScript files:

npm run build

4. Create a .env file with your Officient token: You can get this officient token by inspecting a request when logged in and copying the bearer from the Authselfservice header.

cp .env.example .env
# Edit .env and add your OFFICIENT_TOKEN

Configuration

Environment Variables

Create a .env file in the root directory:

OFFICIENT_TOKEN=your_officient_token_here

To get your Officient token:

1. Log in to your Officient account
2. Open browser developer tools (F12)
3. Go to Network tab
4. Make any request to Officient
5. Look for the Authselfservice header in the request

MCP Client Configuration

Add this server to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "officient": {
      "command": "node",
      "args": [
        "/path/to/officient-mcp-server/build/index.js"
      ],
      "env": {
        "OFFICIENT_TOKEN": "your_token_here"
      }
    }
  }
}

Usage

With Claude Desktop

Once configured, you can use natural language to interact with Officient:

• "List all people in my company"
• "Show me details for person ID 12345"
• "What are my days off this year?"
• "Get my salary slips"
• "Who is on vacation in October 2025?"

Build

# Build once
npm run build

# Watch mode (development)
npm run dev

License

This project is licensed under the MIT License - see the file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.