Back to Browse
Free
Server data from the Official MCP Registry
MCP server for AFKBot PTO management — file, list, and cancel time-off requests.
About
MCP server for AFKBot PTO management — file, list, and cancel time-off requests.
Security Report
7.5
Moderate7.5Low RiskValid MCP server (2 strong, 4 medium validity signals). 3 known CVEs in dependencies (0 critical, 2 high severity) Imported from the Official MCP Registry.
10 files analyzed · 3 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Azure AD tenant ID hosting the AFKBot app registration
Environment variable: AZURE_TENANT_ID
Client ID of the app registration used to authenticate to AFKBot
Environment variable: AZURE_CLIENT_ID
Client secret for the AFKBot app registrationRequired
Environment variable: AZURE_CLIENT_SECRET
AFKBot API base URL — defaults to the production endpoint if omitted
Environment variable: AFKBOT_API_URL
AFKBot Easy Auth app client ID (audience) — defaults to production
Environment variable: AFKBOT_APP_CLIENT_ID
Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
Environment variable: MCP_TRANSPORT
Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.
Environment variable: AUTH_MODE
Log verbosity: debug, info, warn, error
Environment variable: LOG_LEVEL
Documentation
View on GitHubFrom the project's GitHub README.
afkbot-mcp
MCP server for AFKBot PTO management — file time-off requests from any MCP client.
Architecture
┌──────────────┐ stdio ┌──────────────┐ HTTPS ┌──────────────┐
│ MCP Client │◄──────────────►│ afkbot-mcp │◄────────────►│ AFKBot API │
│ (Claude, etc)│ │ MCP Server │ Bearer JWT │ (Azure ACA) │
└──────────────┘ └──────────────┘ └──────┬───────┘
│
┌────────┬───────┼────────┐
│ │ │ │
Float Outlook Autotask Rootly
AFKBot orchestrates PTO requests across Float, Outlook Calendar, Autotask, and Rootly. This MCP server wraps its REST API so any MCP-compatible client can file and manage time-off requests.
Quick Start
Environment Variables
| Variable | Required | Description |
|---|---|---|
AZURE_TENANT_ID | Yes | Azure AD tenant ID (d92c73a4-ccc2-4277-8c5d-73c2849adfa4) |
AZURE_CLIENT_ID | Yes | Your MCP server's app registration client ID |
AZURE_CLIENT_SECRET | Yes | Your MCP server's app registration client secret |
AFKBOT_API_URL | No | AFKBot API URL (defaults to production) |
AFKBOT_APP_CLIENT_ID | No | AFKBot Easy Auth client ID (defaults to production) |
Run Locally
npm ci
npm run build
node dist/index.js
Run with Docker
docker compose up --build
Claude Desktop / Claude Code Config
{
"mcpServers": {
"afkbot": {
"command": "node",
"args": ["/path/to/afkbot-mcp/dist/index.js"],
"env": {
"AZURE_TENANT_ID": "d92c73a4-ccc2-4277-8c5d-73c2849adfa4",
"AZURE_CLIENT_ID": "your-app-client-id",
"AZURE_CLIENT_SECRET": "your-app-client-secret"
}
}
}
}
Available Tools
create_pto_request
File a new PTO request.
| Parameter | Type | Required | Description |
|---|---|---|---|
employee_email | string | Yes | Employee email address |
request_type | string | Yes | full_day or partial_day |
start_date | string | Yes | Start date (YYYY-MM-DD) |
end_date | string | No | End date (defaults to start_date) |
start_time | string | No | Start time for partial day (HH:MM) |
end_time | string | No | End time for partial day (HH:MM) |
details | string | No | Reason or notes |
list_pto_requests
List PTO requests with optional filters.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | pending, approved, declined, or all |
employee_email | string | No | Filter by employee |
limit | number | No | Max results (default: 25) |
offset | number | No | Pagination offset |
get_pto_request
Get details of a specific request.
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id | string | Yes | The PTO request ID |
cancel_pto_request
Cancel a pending or approved request.
| Parameter | Type | Required | Description |
|---|---|---|---|
request_id | string | Yes | The PTO request ID |
reason | string | No | Reason for cancellation |
team_calendar
View who's out on a given date range.
| Parameter | Type | Required | Description |
|---|---|---|---|
start_date | string | Yes | Start date (YYYY-MM-DD) |
end_date | string | No | End date (defaults to start_date) |
Auth Setup
This MCP server authenticates to AFKBot using Azure AD client credentials. You need to create an app registration:
-
Create an App Registration in Azure AD (Entra ID)
- Go to Azure Portal → Entra ID → App registrations → New registration
- Name:
afkbot-mcp(or your choice) - Supported account types: Single tenant
-
Create a Client Secret
- In the app registration → Certificates & secrets → New client secret
- Copy the secret value
-
Grant API Permissions
- In the app registration → API permissions → Add a permission
- Select "APIs my organization uses" → search for AFKBot (
17963178-bee5-4738-82a3-088e739bb95b) - Add the appropriate permissions
- Grant admin consent
-
Set Environment Variables using the values from the app registration
WYRE Ecosystem
This is part of the WYRE Technology MCP server suite:
- autotask-mcp — Kaseya Autotask PSA integration
- afkbot-mcp (this repo) — PTO management via AFKBot
License
MIT — Copyright (c) 2025 Aaron Sachs
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
413
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
58
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
17
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
Google Workspace MCP
Freeby Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI
1.6K
Stars
13
Installs
7.0
Security
No ratings yet
Local