Connect Humaans to Your AI Agent

Choose a team or known person and summarize the fields your access token can read.

4 tools API key

Try a Humaans Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Humaans

Review a Team’s People

Read people matching a team and employment status.

/oo Humaans: List Humaans people in team [team ID] with employment status [status]. Summarize the available names, roles, and work contact details.

Find a Person by Work Email

Find an exact email match and read the selected person record.

/oo Humaans: Find the Humaans person with exact work email [email], then read their full accessible record and summarize the available employment information.

Start Working with Humaans

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Humaans

    Connect a Humaans API access token.

    Connect Humaans →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A Humaans token with public:read or private:read permission for person records.
  • People filters use exact matches. Available fields depend on the token’s public or private read access.

Humaans Tools

Humaans provides token-scope inspection, the current person record, filtered people listings, and individual person lookup.

People and Access Details

Inspect token scopes, read the current person, and find or retrieve people records.

4 tools

Get Token Info

Retrieve the scopes granted to the current Humaans API access token.

humaans.get_token_info

Get Current Person

Retrieve the Humaans person record that owns the current API access token using public:read or private:read access.

humaans.get_current_person

List People

List Humaans people with common exact-match filters and offset pagination using public:read or private:read access.

humaans.list_people

Get Person

Retrieve one Humaans person by identifier using public:read or private:read access.

humaans.get_person

Frequently Asked Questions

Can I search with part of a name?

The listed name and email filters use exact matches. Provide the complete field value or list a team to locate the person.

Why might person details be missing?

The access token controls which public or private fields can be read. Inspect its scopes and use the fields available to that connection.

Can I update a person’s employment details?

The current actions read people and token access. They do not create or modify employee records.

Connect Humaans

About Humaans ↗