Skip to main content
Glama

amulen-mcp

Servidor MCP para AMULEN, la plataforma de gestión de proyectos, tableros y tareas de 3HTP. Permite que asistentes como Claude consulten y actualicen tu trabajo en AMULEN con tus mismos permisos.

  • Autenticación con token personal (sin contraseña).

  • Una llamada por herramienta. Los errores (403, 404, 422…) se devuelven con un mensaje claro.

  • Comentarios y descripciones en Markdown, que AMULEN muestra con formato.

  • Adjuntos de evidencia: archivos locales o textos generados por el agente.

Instalación

1. Crea tu token

En AMULEN → Mi Perfil → Tokens de API → Crear token. Copia el valor (amu_…): se muestra una sola vez. Puedes revocarlo desde el mismo lugar.

2. Configura tu cliente MCP

Necesitas uv. AMULEN_BASE_URL es la dirección de AMULEN que usas en el navegador.

Claude Code

claude mcp add amulen -s user \
  -e AMULEN_BASE_URL=https://amulen.3htp.cloud \
  -e AMULEN_TOKEN=amu_xxx \
  -- uvx amulen-mcp@1.2.0

Claude Desktop y otros clientes (mcpServers en JSON)

{
  "mcpServers": {
    "amulen": {
      "command": "uvx",
      "args": ["amulen-mcp@1.2.0"],
      "env": {
        "AMULEN_BASE_URL": "https://amulen.3htp.cloud",
        "AMULEN_TOKEN": "amu_xxx"
      }
    }
  }
}

Fijar la versión (@1.2.0) evita que una actualización te llegue sin aviso. Para actualizar, cambia el número de versión.

3. Pruébalo

Abre una sesión nueva y pregunta: "¿Tengo tareas en AMULEN?"

Related MCP server: Dot Taskboard MCP Server

Herramientas

Herramienta

Qué hace

amulen_whoami

Usuario del token

amulen_my_tasks

Tus tareas en todos los proyectos (filtros: estado, proyecto, texto, vencidas)

amulen_list_projects / amulen_get_project

Proyectos accesibles / detalle con tableros

amulen_project_dashboard

Métricas: por estado, vencidas, horas, por usuario, bolsas de horas

amulen_list_members

Miembros con su id (para asignar tareas)

amulen_create_project / amulen_update_project

Crear / editar proyecto

amulen_list_boards / amulen_get_board / amulen_create_board

Tableros

amulen_list_tasks / amulen_get_task

Tareas de un tablero / detalle con checklist, comentarios y adjuntos

amulen_create_task / amulen_update_task

Crear / editar (mover de estado, registrar horas reales)

amulen_add_comment

Comentar una tarea (Markdown)

amulen_add_checklist_items / amulen_update_checklist_item / amulen_delete_checklist_item

Checklist

amulen_upload_attachment

Adjuntar evidencia: archivo local (file_path) o texto (nombre + contenido_texto). Máx. 25 MB

amulen_list_attachments / amulen_download_attachment

Ver y descargar adjuntos (a ~/Downloads/amulen/<tarea>/, sin sobrescribir)

No borra tareas, tableros ni proyectos, ni administra usuarios o permisos.

Seguridad

  • El servidor corre en tu máquina y solo habla con la AMULEN_BASE_URL que configures.

  • El token actúa con tus permisos. AMULEN registra en la auditoría cada cambio hecho con él.

  • Si un token se filtra, revócalo en Mi Perfil. Si encuentras una vulnerabilidad, repórtala en privado a los mantenedores (no en un issue público).

Solución de problemas

Mensaje

Causa

unauthorized

Token mal copiado, revocado o expirado

redirect

AMULEN_BASE_URL no apunta al sitio de tu organización

forbidden

No tienes permisos sobre ese proyecto o tablero

blocked_by_waf

El firewall de la red bloqueó la petición antes de llegar a AMULEN

Desarrollo

uv sync
uv run pytest

Las versiones se publican en PyPI al crear un tag vX.Y.Z (GitHub Actions, Trusted Publishing).

Licencia

MIT. Ver LICENSE.

Available Tools

22 tools
amulen_add_checklist_itemsC

Add one or more checklist items to a task. items: [{"titulo": "...", "descripcion": "..."}] (descripcion optional).

Inputs: items (required), task_slug (required), board_slug (required), project_slug (required).

amulen_add_commentB

Add a comment to a task. Write it in Markdown (bold, lists, tables, code blocks, links): AMULEN renders it formatted. formato: markdown (default) | html | texto (no formatting).

Inputs: contenido (required), task_slug (required), board_slug (required), project_slug (required), +1 more.

amulen_create_boardB

Create a board in a project. bolsa_horas + horas_totales turn it into an hour-budget board.

Inputs: nombre (required), project_slug (required), bolsa_horas, horas_totales.

amulen_create_projectB

Create a project. The creator becomes its admin.

Inputs: nombre (required), descripcion.

amulen_create_taskA

Create a task. descripcion is Markdown by default (formato: markdown | html | texto). Dates YYYY-MM-DD. estado defaults to the board's first column. user_ids must be active project members (see amulen_list_members).

Inputs: titulo (required), board_slug (required), project_slug (required), estado, +7 more.

amulen_delete_checklist_itemC
Destructive

Delete a checklist item from a task.

Inputs: item_id (required), task_slug (required), board_slug (required), project_slug (required).

amulen_download_attachmentB

Download a task attachment to a local folder (default: ~/Downloads/amulen/<task_slug>/). Returns the saved path so you can open or analyze the file. Never overwrites existing files.

Inputs: task_slug (required), board_slug (required), project_slug (required), attachment_id (required), +1 more.

amulen_get_boardB
Read-only

Get a board with task counts per state and its hour budget (bolsa de horas: total, spent, scheduled, available).

Inputs: board_slug (required), project_slug (required).

amulen_get_projectB
Read-only

Get a project with the boards I can see in it.

Inputs: project_slug (required).

amulen_get_taskB
Read-only

Get a task with description (HTML and plain text), assignees, checklist (with item ids) and comments.

Inputs: task_slug (required), board_slug (required), project_slug (required).

amulen_list_attachmentsB
Read-only

List a task's attachments (id, file name, content type, size).

Inputs: task_slug (required), board_slug (required), project_slug (required).

amulen_list_boardsA
Read-only

List the boards of a project that I can see, with their columns (valid states) and whether I can edit them.

Inputs: project_slug (required).

amulen_list_membersB
Read-only

List active project members with their user id and role. Use the ids for task assignment (user_ids).

Inputs: project_slug (required).

amulen_list_projectsB
Read-only

List the projects I can access (optionally filtered by name with q).

Inputs: q, limit, offset.

amulen_list_tasksC
Read-only

List tasks in a board.

estado: states to include. mias: only tasks assigned to me. asignado_a: user id. fecha_desde / fecha_hasta: due-date range, format YYYY-MM-DD. q: text search.

Inputs: board_slug (required), project_slug (required), q, mias, +6 more.

amulen_my_tasksA
Read-only

List tasks assigned to me across all projects and boards, in a single call.

estado: states to include (TO DO, DOING, DONE, PENDING, BACKLOG, or ALL). Default: TO DO + DOING. project_slug: limit to one project. q: text search in title/description. vencidas: only tasks whose due date (fecha_fin) already passed. Sorted by due date (soonest first). Use meta.next_offset to paginate.

Inputs: q, limit, estado, offset, +2 more.

amulen_project_dashboardB
Read-only

Project metrics: tasks by state, overdue tasks, hours (projected/real), tasks per user, and per-board hour budgets.

Inputs: project_slug (required).

amulen_update_checklist_itemB

Update a checklist item (mark completed/uncompleted, rename). Get item ids from amulen_get_task.

Inputs: item_id (required), task_slug (required), board_slug (required), project_slug (required), +3 more.

amulen_update_projectA

Rename a project or change its description (project admins only). Note: renaming changes the slug.

Inputs: project_slug (required), nombre, descripcion.

amulen_update_taskB

Update a task; only the fields you pass change. descripcion is Markdown by default. Use it to move a task (estado) or log real hours (horas_reales). user_ids replaces the whole assignee list.

Inputs: task_slug (required), board_slug (required), project_slug (required), estado, +9 more.

amulen_upload_attachmentA

Attach evidence to a task (max 25 MB).

Either file_path: a local file (screenshot, PDF, log, zip...) on this machine; nombre optionally renames it. Or nombre + contenido_texto: a text document you write (e.g. "evidencia.md" with a summary of the work done).

Inputs: task_slug (required), board_slug (required), project_slug (required), nombre, +2 more.

amulen_whoamiA
Read-only

Show the AMULEN user behind the configured token (name, email, roles, tenant).

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 22 tools

    Disambiguation4/5

    Tools are mostly separated cleanly by resource and action across projects, boards, tasks, attachments, checklists, comments, and identity. The main overlap is between amulen_my_tasks and amulen_list_tasks (which also supports 'mias' and 'asignado_a'), but the descriptions clarify cross-project vs board-scoped usage.

    Naming Consistency4/5

    Nearly all tools follow a consistent amulen_ prefix plus verb_noun pattern (get_, list_, create_, update_, add_, delete_, upload_, download_). A few exceptions such as amulen_whoami, amulen_my_tasks, and amulen_project_dashboard break strict verb_noun form but remain readable and predictable.

    Tool Count4/5

    At 22 tools the server is on the high end, but the domain spans projects, boards, tasks, comments, checklists, attachments, and identity, so most tools are justified. It is slightly heavy rather than excessive for the stated scope.

    Completeness3/5

    Core read/create/update workflows are covered, including attachment and checklist lifecycle operations. However, there are no delete operations for tasks, projects, or boards, and no member add/remove or comment edit/delete, which are notable gaps for full project management.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI coding agents to read TeamStorm tasks, comments, attachments, and links, and to perform limited write operations such as adding comments and updating task names, descriptions, or statuses through MCP.
      15
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables an authenticated owner to manage a personal task board over MCP: creating and updating tasks with project, status, assignee, and revision checks, reading ready or blocked items and recent changes, and appending reported workflow activity. It can also open an embedded workspace app in MCP Apps hosts and inspect or retry experimental board notification state.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to navigate and modify Weeek projects, boards, tasks, assignees, comments, tags, and time tracking through the Weeek API, with actions attributed to the API token owner.
      13
      58 npm
      MIT