What is beebole-usage?

A guide for using Beebole's time-tracking service through its MCP connection. Beebole records work hours, projects, tasks, people, timesheets, and reports.

Use it to find projects, tasks, and people; record, edit, delete, or copy hours; submit or review timesheets; manage tags and absence types; and run work and profitability reports.

It explains which prepared operation to use for common requests and how to discover less common operations without making unnecessary calls.

beebole-usage — Skill for Claude Code and Codex by NeoNexAI

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add NeoNexAI/beebole-mcp --skill beebole-usage

Clone the repo

git clone --depth 1 https://github.com/NeoNexAI/beebole-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/neonexai/beebole-mcp/beebole-usage/github.svg)](https://agentmods.dev/skills/neonexai/beebole-mcp/beebole-usage)

Your own site

<a href="https://agentmods.dev/skills/neonexai/beebole-mcp/beebole-usage"><img src="https://agentmods.dev/badge/skills/neonexai/beebole-mcp/beebole-usage/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/neonexai/beebole-mcp/beebole-usage"><img src="https://agentmods.dev/badge/skills/neonexai/beebole-mcp/beebole-usage.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 166 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,190 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00166	$0.01190
Opus 5	$0.00083	$0.00595
Sonnet 5	$0.00033	$0.00238
Haiku 4.5	$0.00017	$0.00119

Measured 8d ago against content hash 5fe9de402f24, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

beebole-usage scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/beebole-usage/SKILL.md · 72 lines

How it starts

The opening of the file, as written. The whole thing — 72 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Beebole — cómo usar el MCP bien

El MCP habla con la API GraphQL de app.beebole.com (auth por cabecera apikey). Tiene 24 tools curadas para el flujo normal de un estudio y 3 genéricas que cubren el 100% de la API (87 queries + 745 mutations). Tu trabajo es resolver la petición con el mínimo de llamadas y sin tropezar con el dominio.

Regla de oro de selección

¿Hay una tool curada para esto? Úsala. Cubren lo habitual:
- Identidad: beebole_whoami
- Proyectos: beebole_list_projects, beebole_get_project, beebole_add_project
- Tareas: beebole_list_tasks, beebole_get_task, beebole_add_task
- Personas: beebole_list_persons, beebole_get_person, beebole_add_person
- Horas: beebole_list_time_records, beebole_count_time_records, beebole_add_time_record, beebole_edit_time_record, beebole_delete_time_records, beebole_clone_time_records
- Timesheets: beebole_submit_timesheet, beebole_approve_timesheet, beebole_reject_timesheet
- Catálogos: beebole_list_tags, beebole_list_absence_types
- Informes: beebole_list_reports, beebole_run_report, beebole_planned_vs_real
¿No hay tool curada? Entonces el patrón de descubrimiento: beebole_search_schema "<palabra clave>" → beebole_describe_operation "<nombre>" (para ver argumentos y tipos exactos) → beebole_graphql con la query/mutation. No inventes nombres de operación: descúbrelos siempre con search→describe primero.

Gotchas de dominio (la causa nº1 de fallos)

Interioriza esto antes de escribir/leer datos; el schema no perdona:

Duración de un fichaje = ENTERO en MINUTOS. 1 h 30 min → 90. Nunca horas decimales (1.5) ni segundos. Si el usuario dice "2 horas", envía 120.
Timestamps = BeeboleTimestamp en MILISEGUNDOS (epoch · 13 dígitos, > 1e10). Una fecha en segundos (10 dígitos) se interpretará mal. Multiplica ×1000.
Crear proyecto o tarea exige categoría: beebole_add_project / beebole_add_task requieren categoryId (o parentId para anidar). Sin ello la API rechaza con NoCategoryOrParentProvided. Si no la tienes, descúbrela primero (search_schema "categor" → describe → query de categorías) y pásala.
Estados (status): d=borrador, s=enviado, a=aprobado, r=rechazado.
Color: índice de paleta 0–71. Ausencias: unidad day o hour.

Read the full file on GitHub · 72 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

8d ago First seen · 72 lines · 166 tokens per session scan A 5fe9de402f24

Subscribe to this mod's changes

beebole-usage is a skill published in the GitHub repository NeoNexAI/beebole-mcp (0 stars, last pushed 2mo ago), licensed MIT. It adds 166 tokens to every session and 1,190 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Project management beebole claude graphql mcp model-context-protocol time-tracking

clockify-automate

Turn on agent-mediated Clockify tracking: if .clockify/config.yml is missing, run minimal clockify-init first, then forge wizard (GitHub) + Cursor Plan/Debug platforms + runaway wizard, ensure project/tasks, write Cursor rules, and when runaway is enabled install Clockify-owned runaway hooks. Use when the user wants…

dustinestes/clockify-agent-plugin · 96 tokens

clockify-init

Bootstrap Clockify for a repo: AskQuestion for workspace only, write v4 .clockify/config.yml from the plugin example (plugin / scope / entry), and default-ignore personal time-tracking files. Use when setting up time tracking (timer or enter-time). Safe to re-run: does not overwrite existing config unless the user…

dustinestes/clockify-agent-plugin · 86 tokens

smartsheet-rm

Enterprise Agent Skill for orchestrating Resource Management by Smartsheet (10,000ft API) — manage weekly timesheets, reconciliation, project staffing, assignments, capacity planning, and user availability.

christianclaudio/mcp-server-smartsheet-rm · 45 tokens

linear-graphql-skill

Operate Linear workspace issues, projects, and teams through Linear GraphQL API using UXC. Use when tasks require querying or creating issues, managing projects, or interacting with Linear workflow. Supports both Personal API Key and OAuth authentication.

holon-run/uxc · 51 tokens

change-management

Create and transition ServiceNow change requests (normal/standard/emergency), change tasks, affected CIs, approval routing, CAB scheduling, and conflict detection across maintenance windows.

serac-labs/serac · 37 tokens

hr-service-delivery

Build ServiceNow HR Service Delivery — snhrcorecase from Employee Center or HR catalog, snhrlelifecycleevent onboarding/offboarding with templated activities, and HR document generation.

serac-labs/serac · 42 tokens