CRM headless · open sourceHeadless CRM · open source

Hilo.

El CRM que opera un agente.The CRM an agent runs.

Los CRM se diseñaron para que una persona haga clic en un tablero. Hilo está al revés: la vía principal es un servidor MCP remoto, y la web es una ventana para ver lo que los agentes hicieron. Código libre, Apache-2.0.

Conectás Claude, ChatGPT, Grok o Cursor, y el agente carga empresas, contactos y oportunidades, registra cada interacción y mueve el funnel. Entrás con Google o Microsoft cuando querés mirar. Un docker compose up y anda.

CRMs were designed for a person clicking around a board. Hilo works the other way around: the main way in is a remote MCP server, and the web is a window to see what the agents did. Open source, Apache-2.0.

Connect Claude, ChatGPT, Grok or Cursor, and the agent loads companies, contacts and opportunities, logs every interaction and moves the funnel. You sign in with Google or Microsoft when you want to look. One docker compose up and it runs.

v0.1.0Go 1.27PostgreSQL 18MCP remoto · OAuth 2.1Remote MCP · OAuth 2.1UI en 6 idiomas6-language UIApache-2.0

CRM de siempreThe usual CRM

  • Una persona carga los datos a mano.
  • Los datos envejecen apenas se cargan.
  • El pipeline refleja lo que alguien se acordó de escribir.
  • A person enters the data by hand.
  • The data goes stale as soon as it's entered.
  • The pipeline reflects what someone remembered to write down.

CRM con agenteCRM with an agent

  • El agente lee el mail, agenda la reunión, escribe la propuesta y registra cada paso.
  • Cada dato entra cuando pasa, con su fecha real.
  • El pipeline refleja lo que pasó.
  • The agent reads the email, books the meeting, writes the proposal and records every step.
  • Each piece of data comes in when it happens, with its real date.
  • The pipeline reflects what happened.
El ciclo

Qué hace un agente en un día de ventas

Un día concreto, de punta a punta. En cada hito, qué superficie usa el agente y qué deja escrito en Hilo.

Ejemplo ilustrativo. Las empresas, personas y montos de este día son inventados. Algunas superficies dependen de que estén conectadas al agente y de que la otra parte lo permita.

  1. Revisa el buzón

    Llega una consulta de un lead nuevo: Marina Ríos, de Talleres Andinos, pregunta por el servicio. El agente la lee, la clasifica como consulta comercial y la carga.

    Superficie
    Buzón propio del agente
    En Hilo
    upsert_company + upsert_contact + upsert_opportunity en la etapa inicial, y log_interaction de tipo email, entrante, con el id del mensaje como external_id.
  2. Busca antecedentes

    Antes de responder, se fija si Talleres Andinos ya existía y si hay otro contacto ahí. Aparece un deal viejo, perdido por precio. Lo deja anotado en la descripción de la oportunidad nueva para que nadie llegue a la reunión sin saberlo.

    Superficie
    Hilo
    En Hilo
    search_crm, get_company, get_timeline y después upsert_opportunity con la descripción actualizada.
  3. Arma la propuesta

    Lee la plantilla en Drive, la completa con los datos del deal —monto, contactos, fecha estimada de cierre— y la guarda como Doc. Adjunta el link a la oportunidad.

    Superficie
    Drive y Docs
    En Hilo
    upsert_opportunity con el monto, la fecha estimada de cierre y el link del documento en links.
  4. Agenda la reunión

    Crea el evento en el calendario y manda la invitación con el link de Meet. La oportunidad avanza de etapa.

    Superficie
    Calendario y Meet
    En Hilo
    move_opportunity_stage, next_step_at con la fecha de la reunión y log_interaction de tipo meeting, saliente.
  5. Entra a la reunión

    Cuando la herramienta de reunión está conectada y los participantes lo permiten, el agente entra, toma notas y al terminar escribe el resumen: qué pidieron, qué objeciones hubo, cuál es el próximo paso y para cuándo.

    Superficie
    Videoconferencia
    En Hilo
    log_interaction con la duración y el resumen.
  6. Actualiza el deal

    Después de la reunión cambió el alcance. El agente ajusta el monto, sube la probabilidad y deja el próximo paso con fecha.

    Superficie
    Hilo
    En Hilo
    upsert_opportunity con amount, probability, next_step y next_step_at.
  7. Revisa qué quedó trabado

    Busca oportunidades sin próximo paso, con fecha de cierre vencida o sin actividad hace dos semanas. Le pasa la lista a la persona, con el motivo de cada una.

    Superficie
    Hilo y el canal donde trabaja la persona
    En Hilo
    needs_attention, que devuelve cada oportunidad con su motivo.
  8. Cierra el día

    Registra un resumen interno de lo que hizo. Nada se cargó a mano.

    Superficie
    Hilo
    En Hilo
    log_interaction de tipo note, interna.
el prompt de ese día
# En vez de ocho pedidos, un solo encargo al agente.

Contexto: vendemos mantenimiento industrial a talleres medianos.
Un buen lead tiene planta propia y más de una máquina.

Hoy quiero que:
1. Revises el buzón y cargues en Hilo cada consulta nueva,
   con empresa, contacto y oportunidad en la etapa inicial.
2. Antes de responder, busques si el cliente ya existía
   y dejes anotado en la oportunidad lo que encuentres.
3. Armes la propuesta desde la plantilla de Drive
   y adjuntes el link al deal.
4. Agendes la reunión y dejes el próximo paso con fecha.
5. Al cierre del día, me pases la lista de oportunidades
   sin próximo paso o sin actividad hace dos semanas,
   con el motivo de cada una.

Reglas: no mandes ningún mail sin mostrármelo.
No prometas descuentos. Registrá cada interacción con su fecha real.

Cada uno de esos pasos es una llamada a una herramienta MCP. No hay un paso escondido donde alguien copia y pega. Y si algo se corta a la mitad, el agente puede reintentar sin duplicar: los upsert son idempotentes y las interacciones aceptan un external_id, así que la segunda vez actualiza lo mismo en lugar de crear otra copia.

The cycle

What an agent does on a sales day

One concrete day, start to finish. At each milestone, which surface the agent uses and what it leaves written in Hilo.

Illustrative example. The companies, people and amounts in this day are made up. Some surfaces depend on being connected to the agent and on the other party allowing it.

  1. Checks the inbox

    An inquiry arrives from a new lead: Marina Ríos, from Talleres Andinos, asks about the service. The agent reads it, classifies it as a sales inquiry and loads it.

    Surface
    The agent's own inbox
    In Hilo
    upsert_company + upsert_contact + upsert_opportunity in the initial stage, and log_interaction of type email, inbound, with the message id as external_id.
  2. Looks up the background

    Before replying, it checks whether Talleres Andinos already existed and whether there is another contact there. An old deal shows up, lost on price. It notes it in the new opportunity's description so nobody walks into the meeting without knowing.

    Surface
    Hilo
    In Hilo
    search_crm, get_company, get_timeline and then upsert_opportunity with the updated description.
  3. Drafts the proposal

    It reads the template in Drive, fills it in with the deal's data (amount, contacts, expected close date) and saves it as a Doc. It attaches the link to the opportunity.

    Surface
    Drive and Docs
    In Hilo
    upsert_opportunity with the amount, the expected close date and the document link in links.
  4. Books the meeting

    It creates the calendar event and sends the invitation with the Meet link. The opportunity moves forward a stage.

    Surface
    Calendar and Meet
    In Hilo
    move_opportunity_stage, next_step_at with the meeting date and log_interaction of type meeting, outbound.
  5. Joins the meeting

    When the meeting tool is connected and the participants allow it, the agent joins, takes notes and, when it ends, writes the summary: what they asked for, which objections came up, what the next step is and by when.

    Surface
    Video call
    In Hilo
    log_interaction with the duration and the summary.
  6. Updates the deal

    After the meeting the scope changed. The agent adjusts the amount, raises the probability and sets the next step with a date.

    Surface
    Hilo
    In Hilo
    upsert_opportunity with amount, probability, next_step and next_step_at.
  7. Checks what got stuck

    It looks for opportunities with no next step, a past close date or no activity in two weeks. It hands the list to the person, with the reason for each one.

    Surface
    Hilo and the channel where the person works
    In Hilo
    needs_attention, which returns each opportunity with its reason.
  8. Wraps up the day

    It logs an internal summary of what it did. Nothing was entered by hand.

    Surface
    Hilo
    In Hilo
    log_interaction of type note, internal.
that day's prompt
# Instead of eight requests, a single assignment for the agent.

Context: we sell industrial maintenance to mid-sized workshops.
A good lead has its own plant and more than one machine.

Today I want you to:
1. Check the inbox and load every new inquiry into Hilo,
   with company, contact and opportunity in the initial stage.
2. Before replying, check whether the customer already existed
   and note in the opportunity whatever you find.
3. Draft the proposal from the Drive template
   and attach the link to the deal.
4. Book the meeting and set the next step with a date.
5. At the end of the day, send me the list of opportunities
   with no next step or no activity in two weeks,
   with the reason for each one.

Rules: don't send any email without showing it to me.
Don't promise discounts. Log every interaction with its real date.

Each of those steps is a call to an MCP tool. There is no hidden step where someone copies and pastes. And if something breaks halfway, the agent can retry without duplicating: the upserts are idempotent and interactions accept an external_id, so the second time it updates the same record instead of creating another copy.

Alrededor del CRM

Las superficies

Hilo no lee mails ni entra a reuniones. Eso lo hace el agente con las herramientas que tenga conectadas. Hilo es donde termina el resultado. Para cada superficie: qué puede hacer el agente ahí y qué escribe en Hilo.

Buzón propio del agente

Qué hace el agente

Con una dirección de mail dedicada: recibe consultas, las clasifica, responde e hila las conversaciones.

Qué escribe en Hilo

Contacto, oportunidad e interacción, con el id del mensaje como external_id para que reintentar no duplique. Canal: Email.

Gmail u otro mail de la empresa

Qué hace el agente

Busca conversaciones viejas para reconstruir el historial de un cliente y redacta respuestas para que la persona las apruebe.

Qué escribe en Hilo

Interacciones entrantes y salientes con su fecha real en occurred_at, no con la fecha en que se cargaron.

Calendario

Qué hace el agente

Propone horarios, crea el evento y lo mueve si se cancela.

Qué escribe en Hilo

El next_step_at de la oportunidad y la interacción de tipo meeting.

Videoconferencia (Meet, Zoom, Teams)

Qué hace el agente

Si la herramienta está conectada y los participantes lo permiten: entra a la reunión, toma notas y saca el resumen.

Qué escribe en Hilo

La interacción con duración, y el resumen de objeciones y próximos pasos. Canal: Videoconferencia.

Drive, Docs y Sheets

Qué hace el agente

Lee plantillas, escribe la propuesta, mantiene una planilla de seguimiento y exporta el pipeline a CSV.

Qué escribe en Hilo

El link del documento en la oportunidad, y los montos y fechas que salieron de la planilla. Una planilla vieja se puede migrar con bulk_upsert.

Redes sociales (X, LinkedIn, Reddit)

Qué hace el agente

Publica, responde comentarios y detecta quién mostró interés, en las cuentas a las que tenga acceso.

Qué escribe en Hilo

Un contacto o una oportunidad con canal social (por ejemplo, LinkedIn), para medir qué canal trae deals y no solo visitas.

Formularios

Cómo entran

Hilo contempla los formularios como origen de un lead: la oportunidad nace con canal formulario y la auditoría registra que vino de un formulario, no de una persona ni de un agente. Cada formulario puede exigir un captcha de Cloudflare Turnstile.

Qué escribe en Hilo

Contacto, oportunidad e interacción de tipo form, con canal Formulario.

La gracia no es cada superficie por separado. Es que todo termina en el mismo lugar.

El agente usa las herramientas que ya usa una persona: el mail, el calendario, la reunión, el documento. Hilo es donde el resultado queda medido.

Around the CRM

The surfaces

Hilo doesn't read emails or join meetings. The agent does that with whatever tools it has connected. Hilo is where the result ends up. For each surface: what the agent can do there and what it writes in Hilo.

The agent's own inbox

What the agent does

With a dedicated email address: it receives inquiries, classifies them, replies and threads the conversations.

What it writes in Hilo

Contact, opportunity and interaction, with the message id as external_id so retrying never duplicates. Channel: Email.

Gmail or other company email

What the agent does

Searches old conversations to rebuild a customer's history and drafts replies for the person to approve.

What it writes in Hilo

Inbound and outbound interactions with their real date in occurred_at, not the date they were loaded.

Calendar

What the agent does

Proposes times, creates the event and moves it if it gets cancelled.

What it writes in Hilo

The opportunity's next_step_at and the interaction of type meeting.

Video calls (Meet, Zoom, Teams)

What the agent does

If the tool is connected and the participants allow it: joins the meeting, takes notes and writes the summary.

What it writes in Hilo

The interaction with its duration, and the summary of objections and next steps. Channel: Video call.

Drive, Docs and Sheets

What the agent does

Reads templates, writes the proposal, keeps a tracking spreadsheet and exports the pipeline to CSV.

What it writes in Hilo

The document link on the opportunity, and the amounts and dates that came from the spreadsheet. An old spreadsheet can be migrated with bulk_upsert.

Social media (X, LinkedIn, Reddit)

What the agent does

Posts, answers comments and spots who showed interest, on the accounts it has access to.

What it writes in Hilo

A contact or an opportunity with a social channel (for example, LinkedIn), to measure which channel brings deals and not just visits.

Forms

How they come in

Hilo treats forms as a lead source: the opportunity is born with the form channel and the audit records that it came from a form, not from a person or an agent. Each form can require a Cloudflare Turnstile captcha.

What it writes in Hilo

Contact, opportunity and interaction of type form, with channel Form.

The point isn't each surface on its own. It's that everything ends up in the same place.

The agent uses the tools a person already uses: email, calendar, the meeting, the document. Hilo is where the result gets measured.

Para quien nunca usó un agente

Cómo se le pide algo

Un agente no es una app con botones. Es alguien a quien le pedís cosas por escrito y que trabaja con las herramientas que le diste. Funciona bien cuando seguís cinco pasos.

  1. Contexto

    El agente no adivina. Decile quién sos, qué vendés, qué es un buen lead y qué no.

    En Hilo, eso se traduce en un pipeline con etapas claras y canales bien nombrados. Si las etapas son confusas para una persona, también lo son para el agente.

    Ejemplo"Vendemos mantenimiento industrial a talleres medianos. Un buen lead tiene planta propia y más de una máquina. Los estudiantes y proveedores no son leads."
  2. Permiso

    El agente solo puede tocar lo que le diste. Si no le conectaste el calendario, no agenda. Si no le diste el buzón, no lee mails.

    Un token de Hilo se puede restringir a solo lectura, y nunca puede ampliar lo que permite el rol de la persona que lo creó.

    EjemploPara empezar, un token de solo lectura: el agente puede responder "cómo viene el mes" sin poder cambiar nada.
  3. Pedido concreto

    Un pedido bueno dice qué mirar, qué hacer y qué devolver.

    Funciona"Buscá en el buzón las consultas de esta semana, cargalas en Hilo y decime cuáles necesitan respuesta hoy."
    No funciona"Ocupate de las ventas."
  4. Borrador antes de enviar

    Todo lo que sale hacia afuera se revisa. El agente redacta, la persona aprueba.

    Ejemplo"Redactá la respuesta a Talleres Andinos con la propuesta adjunta. No la mandes, mostrámela."
  5. Registro

    Lo que pasó queda en la interacción, con fecha. Si no quedó registrado, no pasó.

    Ejemplo"Cuando la mande, registrala en Hilo como email saliente y dejá como próximo paso llamar el jueves."

Qué pedirle y qué no

Sí

  • Reconstruir el historial de un cliente desde el mail.
  • Preparar el resumen de una reunión.
  • Armar la propuesta desde una plantilla.
  • Mover deals trabados.
  • Avisar qué está por vencer.

No

  • Prometer descuentos.
  • Cerrar un deal.
  • Mandar un mail sin revisión.
  • Decidir a qué cliente priorizar sin datos.

Qué sigue decidiendo la persona

El precio, los compromisos, qué se manda hacia afuera y con quién conviene invertir tiempo. El agente prepara, ordena y registra. La persona decide.

El error más común

Pedirle al agente que "mantenga el CRM al día" sin darle acceso al lugar donde pasa la información. El CRM no se mantiene solo. Se mantiene porque el agente ve el mail y la reunión. Sin eso, el agente tiene lo mismo que tenía la persona: nada que cargar.

For someone who has never used an agent

How you ask it for something

An agent isn't an app with buttons. It's someone you ask for things in writing, who works with the tools you gave it. It works well when you follow five steps.

  1. Context

    The agent doesn't guess. Tell it who you are, what you sell, what a good lead is and what isn't.

    In Hilo, that translates into a pipeline with clear stages and well-named channels. If the stages are confusing to a person, they are confusing to the agent too.

    Example"We sell industrial maintenance to mid-sized workshops. A good lead has its own plant and more than one machine. Students and suppliers are not leads."
  2. Permission

    The agent can only touch what you gave it. If you didn't connect the calendar, it doesn't book. If you didn't give it the inbox, it doesn't read email.

    A Hilo token can be restricted to read-only, and it can never go beyond what the role of the person who created it allows.

    ExampleTo start, a read-only token: the agent can answer "how is the month going" without being able to change anything.
  3. A concrete request

    A good request says what to look at, what to do and what to give back.

    Works"Search the inbox for this week's inquiries, load them into Hilo and tell me which ones need an answer today."
    Doesn't work"Take care of sales."
  4. Draft before sending

    Everything that goes out gets reviewed. The agent drafts, the person approves.

    Example"Draft the reply to Talleres Andinos with the proposal attached. Don't send it, show it to me."
  5. Record

    What happened stays in the interaction, with a date. If it wasn't recorded, it didn't happen.

    Example"When you send it, log it in Hilo as an outbound email and set calling on Thursday as the next step."

What to ask for and what not

Yes

  • Rebuild a customer's history from email.
  • Prepare a meeting summary.
  • Put together the proposal from a template.
  • Move stuck deals.
  • Flag what is about to expire.

No

  • Promise discounts.
  • Close a deal.
  • Send an email without review.
  • Decide which customer to prioritize without data.

What the person still decides

The price, the commitments, what goes out and who is worth spending time on. The agent prepares, organizes and records. The person decides.

The most common mistake

Asking the agent to "keep the CRM up to date" without giving it access to where the information happens. The CRM doesn't maintain itself. It stays current because the agent sees the email and the meeting. Without that, the agent has what the person had: nothing to enter.

Que se despierte solo

Cómo se crea una rutina

Hasta acá, el agente trabaja cuando le hablás. La diferencia grande aparece cuando no hace falta que le hables: una rutina es un pedido que queda guardado y se vuelve a ejecutar solo, a la hora que digas o cuando pasa algo.

No hay que configurar nada en una pantalla de ajustes. La rutina se crea pidiéndola, en la misma conversación donde le pedís cualquier otra cosa.

así se pide una rutina
# Se lo escribís al agente, tal cual. Nada de formularios.

Todos los lunes a las 8:30, revisá Hilo y mandame por acá
las oportunidades que necesitan algo: próximas acciones
vencidas, cierres pasados y deals sin actividad hace más
de dos semanas. Para cada una decime el motivo y qué
propondrías hacer.

Si la semana no tiene nada para avisar, no me escribas.

El agente lo guarda con el día, la hora y la zona horaria, y a partir de ahí se dispara solo aunque no estés mirando el chat. Se puede pausar, cambiar de horario o borrar pidiéndolo igual: "pasá la rutina de los lunes a los martes a las 9" o "pausá esa rutina hasta que vuelva de viaje".

Qué tiene que decir un pedido de rutina

1

Cuándo

Un día y una hora, o una frecuencia: todos los lunes, cada mañana a las 8, el día 1 de cada mes. Si es una sola vez, la fecha exacta.

2

Qué mirar

De dónde saca la información: Hilo, el buzón, el calendario. Sin esto el agente adivina, y adivinar es lo que sale mal.

3

Qué devolver

El formato de la respuesta y a dónde va: un mensaje acá, un correo, una nota en el deal. Y cuándo callarse.

Cuatro rutinas que valen la pena el primer día

Son ejemplos de arranque, no una lista cerrada. Cada una se escribe en una frase.

El arranque del lunes lunes 8:30

Las oportunidades que necesitan algo, con el motivo y una propuesta de próximo paso. Usa needs_attention.

El cierre del día todos los días 18:30

Qué se movió hoy, qué se cargó y qué quedó sin registrar. Usa list_changes con el cursor de ayer.

El resumen del viernes viernes 17:00

Cómo viene el mes contra la meta, qué se ganó, qué se estancó y qué canales trajeron deals. Usa get_metrics.

El barrido del buzón cada dos horas

Si entró una consulta nueva, la carga en Hilo y te avisa. Si no entró nada, no dice nada.

rutina que se dispara por un evento
# Además del horario, una rutina puede esperar un evento.

Cuando alguien complete el formulario de la web,
cargalo en Hilo con canal Formulario, avisame en el
momento y proponeme el primer mensaje de respuesta.
No lo mandes: mostrámelo.

Lo que hace que una rutina sirva es la última línea: cuándo no escribir. Un agente que avisa todos los días que no pasó nada se vuelve ruido, y el ruido se ignora. El que solo aparece cuando hay algo se lee.

Let it wake up on its own

How to create a routine

So far, the agent works when you talk to it. The big difference shows up when you don't need to: a routine is a request that gets saved and runs again on its own, at the time you say or when something happens.

There's nothing to configure on a settings screen. You create the routine by asking for it, in the same conversation where you ask for anything else.

how to ask for a routine
# You write this to the agent, as is. No forms.

Every Monday at 8:30, check Hilo and send me here
the opportunities that need something: overdue next
steps, past close dates and deals with no activity in
more than two weeks. For each one tell me the reason
and what you would propose doing.

If the week has nothing to report, don't write to me.

The agent saves it with the day, time and time zone, and from then on it fires on its own even if you're not looking at the chat. You can pause it, reschedule it or delete it by asking the same way: "move the Monday routine to Tuesdays at 9" or "pause that routine until I'm back from my trip".

What a routine request has to say

1

When

A day and a time, or a frequency: every Monday, every morning at 8, the 1st of each month. If it's a one-off, the exact date.

2

What to look at

Where it gets the information from: Hilo, the inbox, the calendar. Without this the agent guesses, and guessing is what goes wrong.

3

What to give back

The format of the answer and where it goes: a message here, an email, a note on the deal. And when to stay quiet.

Four routines worth having on day one

They're starter examples, not a closed list. Each one is written in a sentence.

The Monday kickoff Monday 8:30

The opportunities that need something, with the reason and a proposed next step. Uses needs_attention.

The end of the day every day 18:30

What moved today, what was loaded and what was left unrecorded. Uses list_changes with yesterday's cursor.

The Friday summary Friday 17:00

How the month is going against the goal, what was won, what stalled and which channels brought deals. Uses get_metrics.

The inbox sweep every two hours

If a new inquiry came in, it loads it into Hilo and lets you know. If nothing came in, it says nothing.

a routine triggered by an event
# Besides a schedule, a routine can wait for an event.

When someone fills in the form on the website,
load it into Hilo with channel Form, let me know
right away and propose the first reply message.
Don't send it: show it to me.

What makes a routine useful is the last line: when not to write. An agent that reports every day that nothing happened turns into noise, and noise gets ignored. The one that only shows up when there's something gets read.

El corazón técnico

Las herramientas de Hilo

El servidor MCP expone 24 herramientas. Son todo lo que un agente necesita para operar el CRM, y nada más. Arrastrá las tarjetas para verlas una por una, o bajá a la referencia completa.

The technical core

Hilo's tools

The MCP server exposes 24 tools. They are everything an agent needs to run the CRM, and nothing more. Swipe the cards to see them one by one, or scroll down to the full reference.

Una por unaOne by one

Arrastrá, o usá las flechas y las teclas ← →Drag, or use the arrows and the ← → keys

Las viste todasYou've seen them all 24 de 24 herramientas24 of 24 tools
1 / 24

La referencia completa

Las 24, agrupadas por para qué sirven en la práctica.

Buscar y leer 13

Para que el agente sepa qué pasó antes de hacer algo: quién es este cliente, qué se habló, cómo viene el mes.

  • search_crm
    Encontrar empresas, contactos y oportunidades por nombre, dominio, email o título.
  • list_companies · list_contacts
    Listados filtrables por texto, dueño o etiqueta.
  • list_opportunities
    Filtra por etapa, estado, dueño, canal, fecha de cierre o días sin actividad.
  • list_interactions
    Lo último que pasó en todo el workspace.
  • list_pipelines · list_channels · list_tags
    Las etapas, los canales y las etiquetas que ya existen, para no inventar duplicados.
  • get_company · get_contact · get_opportunity
    Un registro completo.
  • get_timeline
    La historia de una oportunidad, contacto o empresa: interacciones y cambios de etapa.
  • get_metrics
    Cómo viene el pipeline.

Escribir 6

Para dejar asentado lo que el agente hizo o vio: el lead nuevo, el mail que llegó, la reunión que pasó, el deal que avanzó.

  • upsert_company · upsert_contact
    Crea o actualiza. Reconoce el registro por id, external_id, dominio o email.
  • upsert_opportunity
    Monto, probabilidad, fecha estimada de cierre, próximo paso, dueño, canal de origen y links a documentos.
  • move_opportunity_stage
    Mueve de etapa y lo deja en la historia. Pasar a perdida exige un motivo.
  • log_interaction
    Email, llamada, reunión, nota, mensaje, contacto social o formulario. Entrante, saliente o interna.
  • archive_record
    No borra nada: saca el registro de las listas y lo deja en el historial y en el registro de auditoría.

Trabajo en lote 1

Para migrar desde una planilla o un sistema anterior en pocas llamadas, y probar antes de guardar.

  • bulk_upsert
    Hasta 200 registros en una llamada. Con dry_run valida una migración entera sin guardar nada.

Para agentes que vuelven solos 2

Para que un agente que se despierta cada mañana sepa qué cambió y qué necesita a alguien, sin releer todo.

  • needs_attention
    Oportunidades abiertas que necesitan a alguien, con el motivo: próximo paso vencido, fecha de cierre pasada, sin actividad, sin dueño, sin próximo paso.
  • list_changes
    Todo lo que cambió, con cursor, para saber qué pasó desde la última vez que miró. Distingue si el cambio lo hizo una persona, un agente o un formulario.

Administración 2

Para definir cómo se vende: qué etapas hay y de dónde pueden venir los leads. Solo para administradores.

  • configure_pipeline
    Las etapas del pipeline, en orden, con su categoría y su probabilidad.
  • upsert_channel
    Crear o renombrar canales.

Las referencias entre registros aceptan el id de Hilo, la clave natural (dominio de la empresa, email del contacto) o el external_id del sistema de origen, así que un agente que sincroniza o migra no necesita guardar ids. Cada agente ve solo las herramientas que su rol y su token permiten.

Etapas: el nombre es libre, la categoría no

Cada etapa pertenece a una de cuatro categorías:

initialin_progresswonlost

El estado de una oportunidad sigue a la categoría de su etapa, así que las métricas no dependen de cómo se llamen las columnas. La validación exige exactamente una etapa inicial, al menos una en progreso, una ganada y una perdida.

Cada etapa tiene además una probabilidad. El pipeline de ventas viene con 10, 25, 50, 75, 100 y 0 %. Eso es lo que hace que el monto ponderado signifique algo. Se puede marcar un pipeline como predeterminado y definirle una meta mensual con moneda. Si se borra una etapa, hay que reasignar las oportunidades que estaban ahí.

Canales: de dónde vino cada lead

Los canales existen para poder responder una pregunta: qué trae deals, no solo visitas. Vienen diez de fábrica:

EmailEventoFormularioLinkedInOutboundReferidoTeléfonoVideoVideoconferenciaWeb

Cada canal tiene un tipo: web, form, email, phone, social, referral, event, outbound, partner, ads, videocall, video u other.

Qué mide get_metrics

  • Volumen abierto y valor ponderado por etapa.
  • Ganadas y perdidas, con montos, y tasa de cierre.
  • Ciclo promedio de las ganadas y días promedio en cada etapa.
  • Oportunidades estancadas y nuevas oportunidades por canal.
  • Interacciones por semana y avance contra la meta del mes.

La ventana por defecto es de 90 días. Una oportunidad se considera estancada tras 14 días sin actividad.

The full reference

All 24, grouped by what they're for in practice.

Search and read 13

So the agent knows what happened before doing anything: who this customer is, what was discussed, how the month is going.

  • search_crm
    Find companies, contacts and opportunities by name, domain, email or title.
  • list_companies · list_contacts
    Lists filterable by text, owner or tag.
  • list_opportunities
    Filters by stage, status, owner, channel, close date or days without activity.
  • list_interactions
    The latest that happened across the whole workspace.
  • list_pipelines · list_channels · list_tags
    The stages, channels and tags that already exist, to avoid inventing duplicates.
  • get_company · get_contact · get_opportunity
    A complete record.
  • get_timeline
    The history of an opportunity, contact or company: interactions and stage changes.
  • get_metrics
    How the pipeline is doing.

Write 6

To record what the agent did or saw: the new lead, the email that arrived, the meeting that happened, the deal that moved forward.

  • upsert_company · upsert_contact
    Creates or updates. Recognizes the record by id, external_id, domain or email.
  • upsert_opportunity
    Amount, probability, expected close date, next step, owner, source channel and links to documents.
  • move_opportunity_stage
    Moves the stage and keeps it in the history. Moving to lost requires a reason.
  • log_interaction
    Email, call, meeting, note, message, social touch or form. Inbound, outbound or internal.
  • archive_record
    Deletes nothing: takes the record out of lists and keeps it in the history and the audit log.

Batch work 1

To migrate from a spreadsheet or a previous system in a few calls, and test before saving.

  • bulk_upsert
    Up to 200 records in one call. With dry_run it validates an entire migration without saving anything.

For agents that come back on their own 2

So an agent that wakes up every morning knows what changed and what needs someone, without rereading everything.

  • needs_attention
    Open opportunities that need someone, with the reason: next step overdue, close date passed, no activity, no owner, no next step.
  • list_changes
    Everything that changed, with a cursor, to know what happened since the last time it looked. It tells apart whether the change was made by a person, an agent or a form.

Administration 2

To define how you sell: which stages exist and where leads can come from. Admins only.

  • configure_pipeline
    The pipeline stages, in order, with their category and probability.
  • upsert_channel
    Create or rename channels.

References between records accept Hilo's id, the natural key (company domain, contact email) or the source system's external_id, so an agent that syncs or migrates doesn't need to keep ids. Each agent sees only the tools its role and its token allow.

Stages: the name is free, the category isn't

Each stage belongs to one of four categories:

initialin_progresswonlost

An opportunity's status follows its stage's category, so metrics don't depend on what the columns are called. Validation requires exactly one initial stage, at least one in progress, one won and one lost.

Each stage also has a probability. The sales pipeline comes with 10, 25, 50, 75, 100 and 0 %. That's what makes the weighted amount mean something. A pipeline can be marked as the default and given a monthly goal with a currency. If a stage is deleted, its opportunities have to be reassigned.

Channels: where each lead came from

Channels exist to answer one question: what brings deals, not just visits. Ten come out of the box:

EmailEventFormLinkedInOutboundReferralPhoneVideoVideo callWeb

Each channel has a type: web, form, email, phone, social, referral, event, outbound, partner, ads, videocall, video or other.

What get_metrics measures

  • Open volume and weighted value per stage.
  • Won and lost, with amounts, and win rate.
  • Average cycle of won deals and average days in each stage.
  • Stalled opportunities and new opportunities per channel.
  • Interactions per week and progress against the month's goal.

The default window is 90 days. An opportunity is considered stalled after 14 days without activity.

Control y auditoría

Un agente no tiene más permisos que una persona

Cada llamada de un agente pasa por las mismas reglas de permisos y la misma auditoría que si la hubiera hecho una persona.

Roles

LectorMiembroAdminPropietarioSuperadmin
  • Scopes separados. El servidor distingue crm:read, crm:write y crm:admin. Admin incluye configurar pipelines y canales, y usar fechas históricas para migraciones. Por eso un token de solo lectura es de solo lectura de verdad.
  • Quién hizo qué. list_changes distingue si un cambio lo hizo una persona, un agente o un formulario.
  • Historia completa. Todo lo que pasó se ve en el timeline de cada oportunidad y en el registro de auditoría del workspace.
  • Archivar no es borrar. archive_record saca el registro de las listas y lo deja en el historial y en la auditoría.
  • Infraestructura. Los contenedores corren sin root y con sistema de archivos de solo lectura. La base usa Row-Level Security por workspace.

Quién puede entrar

Un email verificado por Google o Microsoft cuyo dominio esté habilitado por un superadmin, o con una invitación pendiente. Sin dominios configurados, solo superadmins e invitados.

Lector
leer
Miembro
leer y escribir datos del CRM
Admin
además, configurar pipelines, canales, formularios, miembros y dominios
Propietario
además, gestionar propietarios
Superadmin
de la plataforma: dominios habilitados para entrar, marca de la aplicación y vista de todos los workspaces

Pensado para estar expuesto a internet

Un servidor MCP remoto tiene que estar en internet, así que Hilo se armó para eso.

  • OAuth 2.1. MCP remoto (Streamable HTTP) con registro dinámico de clientes, Client ID Metadata Documents, PKCE obligatorio, rotación de refresh tokens y tokens personales para clientes sin OAuth.
  • Multi-workspace. Row-Level Security de Postgres y claves foráneas compuestas por workspace: un workspace no ve los datos de otro.
  • Mínimo privilegio. Roles de base de datos separados, contenedores sin root y de solo lectura, CSP estricta.
  • Secretos cifrados. Las claves de terceros que un admin carga desde la interfaz (como la del captcha) se guardan cifradas con AES-256-GCM.

Formularios de leads, con captcha

Los formularios públicos crean contacto, oportunidad e interacción, sin poder sobrescribir datos existentes. Cada formulario puede exigir un captcha de Cloudflare Turnstile (gratis), que Hilo verifica en el servidor antes de guardar. Las claves son de cada workspace y las carga un admin desde la interfaz, sin tocar el servidor. Si el formulario tiene orígenes permitidos, el captcha tiene que haberse resuelto en uno de esos sitios.

  1. En Cloudflare, Turnstile → Add widget con los dominios de las webs donde van los formularios. Te da una clave pública y una secreta.
  2. En Ajustes → Formularios → Captcha, pegás las dos claves y tocás Guardar claves. La secreta se guarda cifrada y no se vuelve a mostrar: solo sus últimos 4 caracteres.
  3. Copiás el snippet del formulario a tu web (ya trae el script y el widget) y después tocás Exigir captcha en ese formulario.

Respetá el orden. Si el captcha se activa antes de que la web tenga el widget, el formulario rechaza todos los envíos. Sin claves guardadas Hilo no deja activarlo. Los formularios nuevos traen el captcha activado.

Control and audit

An agent has no more permissions than a person

Every agent call goes through the same permission rules and the same audit as if a person had made it.

Roles

ViewerMemberAdminOwnerSuperadmin
  • Separate scopes. The server distinguishes crm:read, crm:write and crm:admin. Admin includes configuring pipelines and channels, and using historical dates for migrations. That's why a read-only token really is read-only.
  • Who did what. list_changes tells apart whether a change was made by a person, an agent or a form.
  • Full history. Everything that happened shows in each opportunity's timeline and in the workspace audit log.
  • Archiving is not deleting. archive_record takes the record out of lists and keeps it in the history and the audit.
  • Infrastructure. Containers run rootless with a read-only filesystem. The database uses Row-Level Security per workspace.

Who can sign in

A Google- or Microsoft-verified email whose domain is enabled by a superadmin, or one with a pending invitation. Without configured domains, only superadmins and invited people.

Viewer
read
Member
read and write CRM data
Admin
also configure pipelines, channels, forms, members and domains
Owner
also manage owners
Superadmin
platform-wide: domains allowed to sign in, application branding and a view of every workspace

Built to be exposed to the internet

A remote MCP server has to live on the internet, so Hilo was built for that.

  • OAuth 2.1. Remote MCP (Streamable HTTP) with dynamic client registration, Client ID Metadata Documents, mandatory PKCE, refresh token rotation and personal tokens for clients without OAuth.
  • Multi-workspace. Postgres Row-Level Security and composite per-workspace foreign keys: one workspace can't see another's data.
  • Least privilege. Separate database roles, rootless read-only containers, strict CSP.
  • Encrypted secrets. Third-party keys an admin enters in the interface (such as the captcha key) are stored encrypted with AES-256-GCM.

Lead forms, with a captcha

Public forms create a contact, an opportunity and an interaction, without being able to overwrite existing data. Each form can require a Cloudflare Turnstile captcha (free), which Hilo verifies on the server before saving. The keys belong to each workspace and an admin enters them in the interface, without touching the server. If the form has allowed origins, the captcha must have been solved on one of those sites.

  1. In Cloudflare, Turnstile → Add widget with the domains of the websites where the forms live. You get a public key and a secret one.
  2. In Settings → Forms → Captcha, paste both keys and press Save keys. The secret is stored encrypted and never shown again: only its last 4 characters.
  3. Copy the form's snippet to your website (it already includes the script and the widget) and then press Require captcha on that form.

Keep that order. If the captcha is turned on before the website has the widget, the form rejects every submission. Without saved keys Hilo won't let you turn it on. New forms come with the captcha on.

Cómo se ve

Lo que ve la persona

La web es chica a propósito: muestra lo que hicieron los agentes y deja que una persona mire y decida. Estas pantallas son de un workspace de demo con la historia de Talleres Andinos de más arriba.

En vivoMedio minuto de funnel mientras dos agentes trabajan por MCP: ChatGPT carga un lead nuevo y califica otro; Claude avanza dos deals, ajusta un monto y cierra uno como ganado. Cada tarjeta que tocan se ilumina, y abajo a la derecha aparece quién lo hizo. Nadie tocó la pantalla.
El funnel en el momento en que Claude, conectado por MCP, mueve la oportunidad de Talleres Andinos a Propuesta, con el aviso en pantalla.
El funnel se actualiza solo mientras el agente trabaja. Abajo a la derecha, el aviso de lo que acaba de hacer: Claude movió la oportunidad de Talleres Andinos a Propuesta.
La oportunidad de Talleres Andinos con su etapa, los links a la propuesta y a la grabación, y los contactos con su rol.
La oportunidad: etapa, links a la propuesta en Drive y a la grabación de la reunión, y los contactos con su rol.
El timeline del día: consulta entrante, antecedentes, propuesta, reunión y cierre del día.
El día de ventas, tal como quedó registrado: cada paso con su fecha real. Nada se cargó a mano.
El dashboard con oportunidades abiertas, valor ponderado, win rate, monto ganado por mes, funnel por etapa, oportunidades por canal y actividad por agente.
El dashboard mide lo que pasó: valor ponderado por etapa, win rate, ciclo, objetivo del mes, de qué canal vienen los deals y qué hizo cada agente.
El funnel en el celular y el menú que se abre deslizando desde la izquierda.
En el celular: el funnel en una columna y el menú, que se abre deslizando el dedo desde la izquierda.
What it looks like

What the person sees

The web is small on purpose: it shows what the agents did and lets a person look and decide. These screens come from a demo workspace with made-up companies.

LiveHalf a minute of the funnel while two agents work over MCP: ChatGPT loads a new lead and qualifies another; Claude moves two deals forward, adjusts an amount and closes one as won. Every card they touch lights up, and the bottom right shows who did it. Nobody touched the screen.
The funnel while Claude, connected over MCP, moves an opportunity: the board updates and a notice says who did it.
The funnel updates on its own while the agent works. Bottom right, the notice of what it just did: Claude moved a deal to Negotiation.
An opportunity with its stage, files and links, contacts and the timeline the agents wrote.
The opportunity: stage, links to external files, contacts and the timeline the agents wrote.
Interactions logged by agents: emails, calls, meetings and notes.
Every email, call and meeting, logged with its real date. Nothing was entered by hand.
Dashboard with open opportunities, weighted value, win rate, amount won per month, funnel by stage, new opportunities by channel and activity by agent.
The dashboard measures what happened: weighted value per stage, win rate, cycle, the month's goal, which channel brings deals and what each agent did.
The funnel on a phone and the menu drawer that opens with a swipe from the left.
On a phone: the funnel in one column and the menu, which opens with a swipe from the left.
La terminal con hiloctl watch mostrando, en vivo, cada cambio que hacen Claude y ChatGPT.
Desde la terminal, hiloctl watch muestra en vivo cada cambio y qué agente lo hizo.From the terminal, hiloctl watch shows every change live and which agent made it.

La web, en detalle

  • Funnel con arrastre entre etapas, deshacer y motivo de pérdida.
  • Dashboard con volumen y valor ponderado por etapa, win rate, ciclo, tiempo en etapa, oportunidades estancadas, leads por canal, interacciones por semana, monto ganado por mes y objetivo mensual por pipeline.
  • Empresas, contactos y oportunidades: listas, fichas con timeline, edición, tags con sugerencias, búsqueda, filtros, acciones en lote y exportación CSV.
  • Interacciones y auditoría de todo lo que pasó, venga de un agente o de una persona.
  • En tiempo real: mientras un agente trabaja, el funnel, las listas, las fichas y el dashboard se actualizan solos, con un aviso de quién hizo qué.
  • Ajustes: pipelines, canales, formularios, miembros, dominios habilitados y marca de la aplicación (nombre y logo).
  • Seis idiomas: inglés, español, francés, italiano, alemán y portugués. La interfaz sigue el idioma del navegador o el que elijas; montos y fechas usan el formato de cada idioma, y un workspace nuevo nace con su pipeline y sus canales en el idioma de quien lo crea.
  • En el celular: una sola columna, un menú que se abre deslizando desde la izquierda, y tablas y funnel que se desplazan de costado dentro de su tarjeta.

Más pantallas. Estas son del workspace de demo en inglés: la interfaz es la misma en los seis idiomas.

The web, in detail

  • Funnel with drag between stages, undo and loss reason.
  • Dashboard with volume and weighted value per stage, win rate, cycle, time in stage, stalled opportunities, leads by channel, interactions per week, amount won per month and a monthly goal per pipeline.
  • Companies, contacts and opportunities: lists, records with a timeline, editing, tags with suggestions, search, filters, bulk actions and CSV export.
  • Interactions and audit of everything that happened, whether it came from an agent or a person.
  • Real time: while an agent works, the funnel, lists, records and dashboard update on their own, with a notice of who did what.
  • Settings: pipelines, channels, forms, members, allowed domains and application branding (name and logo).
  • Six languages: English, Spanish, French, Italian, German and Portuguese. The interface follows the browser's language or the one you pick; amounts and dates use each language's format, and a new workspace starts with its pipeline and channels in its creator's language.
  • Works on a phone: one column, a menu drawer you open with a swipe from the left, and tables and the funnel that scroll sideways inside their card.

More screens, from the English demo workspace.

Ajustes de agentes: la URL del servidor MCP, los agentes conectados y los tokens personales.
Agentes: la URL MCP, los agentes conectados por OAuth y los tokens personales.Agents: the MCP URL, agents connected over OAuth and personal tokens.
La pantalla de consentimiento OAuth cuando se conecta un agente.
Consentimiento: lo que ve la persona cuando conecta un agente, con la opción de solo lectura.Consent: what the person sees when connecting an agent, with read-only as an option.
La auditoría, que distingue personas, agentes y formularios.
Auditoría: quién hizo qué, persona o agente, y con qué cliente.Audit: who did what, person or agent, and with which client.
El editor de pipelines con etapas, categorías, probabilidades y objetivo mensual.
Pipelines: etapas, categorías, probabilidades y objetivo mensual.Pipelines: stages, categories, probabilities and a monthly goal.
La lista de empresas con industria, país, contactos y última actividad.
Empresas, contactos y oportunidades, con búsqueda, filtros y acciones en lote.Companies, contacts and opportunities, with search, filters and bulk actions.
La pantalla de inicio de sesión.
Entrar con Google o Microsoft; los agentes se conectan por MCP.Sign in with Google or Microsoft; agents connect over MCP.
Conectar un agente

Una URL y listo

El servidor MCP vive en https://<tu-dominio>/mcp. Cualquier cliente MCP se conecta de una de dos formas: con OAuth (pegás la URL, Hilo te pide iniciar sesión, elegís el workspace y autorizás) o con un token personal, para los clientes que solo aceptan un encabezado.

Las herramientas que ya usás (buzón, Gmail, calendario, videoconferencia, Drive, Docs, redes, formularios) se conectan al agente, y el agente registra todo en Hilo por MCP.
Todo en una imagen: las herramientas que ya usás se conectan al agente, y el agente registra todo en Hilo por MCP.
Connect an agent

One URL and you're in

The MCP server lives at https://<your-domain>/mcp. Any MCP client connects in one of two ways: with OAuth (paste the URL, Hilo asks you to sign in, you pick the workspace and authorize) or with a personal token, for clients that only accept a header.

The tools you already use (inbox, Gmail, calendar, video calls, Drive, Docs, social media, forms) connect to the agent, and the agent records everything in Hilo over MCP.
All in one picture: the tools you already use connect to the agent, and the agent records everything in Hilo over MCP.

Claude (web y escritorio)

Ajustes → Conectores → Agregar conector personalizado → pegás la URL. Se abre Hilo para iniciar sesión y autorizar; elegís el workspace y, si querés, acceso de solo lectura.

Claude Code

claude mcp add --transport http hilo https://<tu-dominio>/mcp

La primera vez abre el navegador para autorizar con OAuth.

Grok (API de xAI)

Herramienta {"type": "mcp", "server_url": "https://<tu-dominio>/mcp", "authorization": "hilo_pat_…"} en /v1/responses. Va el token solo: xAI agrega Bearer.

ChatGPT, Cursor y otros

Agregás la URL como servidor MCP remoto. Si el cliente no soporta OAuth, creás un token personal en Ajustes → Agentes y lo mandás como Authorization: Bearer hilo_pat_….

Claude (web and desktop)

Settings → Connectors → Add custom connector → paste the URL. Hilo opens so you can sign in and authorize; you pick the workspace and, if you want, read-only access.

Claude Code

claude mcp add --transport http hilo https://<your-domain>/mcp

The first time it opens the browser to authorize with OAuth.

Grok (xAI API)

Tool {"type": "mcp", "server_url": "https://<your-domain>/mcp", "authorization": "hilo_pat_…"} in /v1/responses. Send the token alone: xAI adds Bearer.

ChatGPT, Cursor and others

Add the URL as a remote MCP server. If the client doesn't support OAuth, create a personal token in Settings → Agents and send it as Authorization: Bearer hilo_pat_….

¿Token u OAuth? Son dos caminos para el mismo acceso, nunca los dos a la vez. Un cliente con OAuth no necesita ningún token: pegás la URL y autorizás. El token personal es para lo que no sabe hacer OAuth, como la API de xAI, scripts propios o integraciones por encabezado. Los dos se pueden limitar a solo lectura, y ninguno puede ampliar lo que permite el rol de quien lo creó.

Token or OAuth? They are two roads to the same access, never both at once. A client with OAuth needs no token: paste the URL and authorize. The personal token is for whatever can't do OAuth, such as the xAI API, your own scripts or header-based integrations. Both can be limited to read-only, and neither can widen what the creator's role allows.

Desde la terminal

hiloctl: todo sin abrir la web

Workspaces, miembros, tokens, pipelines, importaciones y backups se manejan con hiloctl, que viene dentro del contenedor web (en el servidor, por SSH). Actúa como operador, con las mismas reglas que la web: por ejemplo, ningún workspace se queda sin propietario.

algunos comandos
# Crear un workspace, sumar a alguien y darle un token a un agente
docker compose exec web hiloctl workspace create "Acme" --owner ana@acme.test --lang es
docker compose exec web hiloctl member add acme bob@acme.test member
docker compose exec web hiloctl token create acme ana@acme.test grok --read-only --ttl 90d

# Ver en vivo lo que hacen los agentes
docker compose exec web hiloctl watch acme

# Todo el workspace en JSON, y de vuelta (validando primero)
docker compose exec -T web hiloctl export acme > acme.json
docker compose exec -T web hiloctl import otro --dry-run < acme.json

# Un CSV exportado de otro CRM
docker compose exec -T web hiloctl import-csv acme contact --source hubspot --dry-run < contacts.csv
From the terminal

hiloctl: everything without opening the web

Workspaces, members, tokens, pipelines, imports and backups are handled with hiloctl, which ships inside the web container (on the server, over SSH). It acts as the operator, with the same rules as the web: for example, no workspace is ever left without an owner.

a few commands
# Create a workspace, add someone and give an agent a token
docker compose exec web hiloctl workspace create "Acme" --owner ana@acme.test --lang en
docker compose exec web hiloctl member add acme bob@acme.test member
docker compose exec web hiloctl token create acme ana@acme.test grok --read-only --ttl 90d

# Watch what the agents are doing, live
docker compose exec web hiloctl watch acme

# The whole workspace as JSON, and back (validating first)
docker compose exec -T web hiloctl export acme > acme.json
docker compose exec -T web hiloctl import other --dry-run < acme.json

# A CSV exported from another CRM
docker compose exec -T web hiloctl import-csv acme contact --source hubspot --dry-run < contacts.csv
hiloctl import-csv en modo prueba, con el mapeo de columnas y las filas rechazadas.
Importar un CSV de otro CRM: mapeo de columnas y prueba antes de guardar.Import a CSV from another CRM: column mapping and a dry run before saving.
hiloctl token create y token list: el token completo se muestra una sola vez.
Tokens personales para agentes sin OAuth. El token completo se muestra una sola vez.Personal tokens for agents without OAuth. The full token is shown only once.
  • Export e import. export produce el mismo formato que lee import (y la herramienta bulk_upsert): sirve de backup legible, para mover un workspace a otro Hilo y para migraciones grandes sin agente. Importarlo de nuevo nunca duplica.
  • CSV de otro CRM. Desde Ajustes → Importar o con hiloctl import-csv para archivos grandes. Hilo reconoce las columnas en español o inglés, te deja ajustarlas y valida todo con una prueba antes de guardar. Ambos pasan por los mismos upsert que usan los agentes.
  • Sin web, si querés. Con HILO_UI=minimal la web queda reducida a lo que necesita el OAuth de los agentes (iniciar sesión y consentimiento). Con HILO_UI=off no hay páginas ni OAuth, y los agentes entran con tokens emitidos por hiloctl.
  • Agentes pre-aprobados. hiloctl client preapprove deja que un agente se conecte sin pantalla de consentimiento, con lectura y escritura o solo lectura, y nunca con permisos de administración.
  • Export and import. export produces the same format import reads (and the bulk_upsert tool): it works as a readable backup, to move a workspace to another Hilo and for large migrations without an agent. Importing it again never duplicates.
  • A CSV from another CRM. From Settings → Import, or with hiloctl import-csv for large files. Hilo recognizes columns in Spanish or English, lets you adjust them and validates everything with a dry run before saving. Both go through the same upserts the agents use.
  • No web, if you prefer. With HILO_UI=minimal the web is reduced to what agents' OAuth needs (sign-in and consent). With HILO_UI=off there are no pages and no OAuth, and agents sign in with tokens issued by hiloctl.
  • Pre-approved agents. hiloctl client preapprove lets an agent connect without a consent screen, with read and write or read-only, and never with administration permissions.
Probalo

Levantarlo en tu máquina

Hace falta Docker. Go 1.27 o más nuevo, solo si vas a tocar el código.

en local
git clone https://github.com/jrcoronel-moon/hilo-crm.git
cd hilo-crm
cp .env.example .env
# completá los secretos (el archivo explica cómo generarlos) y, para probar sin Google ni Microsoft:
#   DEV_LOGIN_ENABLED=true   SUPERADMIN_EMAILS=vos@tuempresa.com
make up          # http://localhost:8080

Entrás con tu email (modo desarrollo), creás un workspace y en Ajustes → Agentes está la URL MCP para pegar en tu agente.

El banner de arranque del contenedor mcp, con su commit, su migración y lo que tiene habilitado.
Cada servicio imprime al arrancar un banner con su commit, su migración y lo que tiene habilitado.

Cómo está armado

Un contenedor por componente. Solo uno da a internet.

caddy
Único punto expuesto. TLS automático (Let's Encrypt), límite de cuerpo, compresión.
web
Login con Google o Microsoft, consentimiento OAuth, tablero, dashboard, ajustes, superadmin y endpoint de formularios.
mcp
Servidor MCP sin estado. Solo valida tokens; nunca los emite.
db
Postgres 18. Sin puertos publicados, en una red sin salida a internet.
migrate
Aplica las migraciones con su propio rol y termina.
backup
pg_dump diario comprimido, con retención configurable.

Stack: Go 1.27, net/http, pgx + sqlc (SQL tipado, sin SQL dinámico), el SDK oficial de MCP para Go, html/template, Postgres 18 y Caddy 2.

Calidad, en cada commit

Tests unitarios, de integración y de punta a punta contra un Postgres real, con -race. Lint con análisis de seguridad, búsqueda de secretos en todo el historial, vulnerabilidades en dependencias e imágenes, y un escaneo OWASP ZAP contra el stack levantado. Los tests cubren aislamiento entre workspaces, la matriz de permisos, el flujo OAuth completo con ataques, CSRF, XSS, open redirect, fuzzing y que ninguna traducción falte en ningún idioma.

Try it

Run it on your machine

You need Docker. Go 1.27 or newer, only if you're going to touch the code.

locally
git clone https://github.com/jrcoronel-moon/hilo-crm.git
cd hilo-crm
cp .env.example .env
# fill in the secrets (the file explains how to generate them) and, to try it without Google or Microsoft:
#   DEV_LOGIN_ENABLED=true   SUPERADMIN_EMAILS=you@yourcompany.com
make up          # http://localhost:8080

Sign in with your email (development mode), create a workspace, and the MCP URL to paste into your agent is in Settings → Agents.

The startup banner of the mcp container, with its commit, its migration and what is enabled.
Each service prints a banner at startup with its commit, its migration and what is enabled.

How it's built

One container per component. Only one faces the internet.

caddy
The only exposed endpoint. Automatic TLS (Let's Encrypt), body limit, compression.
web
Google or Microsoft sign-in, OAuth consent, board, dashboard, settings, superadmin and the form endpoint.
mcp
Stateless MCP server. It only validates tokens; it never issues them.
db
Postgres 18. No published ports, on a network with no internet access.
migrate
Applies migrations with its own role and exits.
backup
Daily compressed pg_dump, with configurable retention.

Stack: Go 1.27, net/http, pgx + sqlc (typed SQL, no dynamic SQL), the official MCP Go SDK, html/template, Postgres 18 and Caddy 2.

Quality, on every commit

Unit, integration and end-to-end tests against a real Postgres, with -race. Lint with security analysis, secret scanning across the whole history, vulnerability checks on dependencies and images, and an OWASP ZAP scan against the running stack. The tests cover isolation between workspaces, the permission matrix, the full OAuth flow with attacks, CSRF, XSS, open redirect, fuzzing and that no translation is missing in any language.

The detailed docs are in Spanish.

CódigoCode

Si esto te sirveIf this is useful to you

El código de Hilo es Apache-2.0 y vive en este repositorio:Hilo's code is Apache-2.0 and lives in this repository:

github.com/jrcoronel-moon/hilo-crm

Se levanta con Docker y se conecta a Claude, ChatGPT, Grok o Cursor desde Ajustes → Agentes.It runs with Docker and connects to Claude, ChatGPT, Grok or Cursor from Settings → Agents.

¿Necesitás que lo implementemos?Need us to implement it?

El código es libre y lo podés levantar vos. Si preferís que quede andando en tu empresa —pipeline armado, canales, agentes conectados al mail y al calendario, y el equipo sabiendo pedirle cosas—, se puede hacer por vos.

The code is free and you can run it yourself. If you'd rather have it up and running in your company (pipeline set up, channels, agents connected to email and calendar, and the team knowing how to ask them for things), it can be done for you.