# Namely MCP by usefulapi

> Namely MCP by usefulapi is an MCP server. Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to the feed. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/namely/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/namely
- **MCP Registry name:** io.usefulapi/namely
- **Listing updated:** 2026-11-13

## About

Read Namely employee profiles, groups, teams, jobs and reports; update profiles, post to the feed.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http namely https://namely.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://namely.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "namely": {
      "url": "https://namely.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "namely": {
      "type": "http",
      "url": "https://namely.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "namely": {
      "serverUrl": "https://namely.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "namely": {
      "type": "http",
      "url": "https://namely.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `namely_get_me`: Get the profile of the user the connected token belongs to (name, email, job title, manager, access role). Namely API: GET /profiles/me.
- `namely_list_profiles`: List employee profiles (active, pending and inactive unless filtered) with paging, sorting and filters. Returns {profiles, meta:{count}, linked}. Use format=short for a smaller record (ids, names, email, status, job title); the full record includes every custom field the token may see (compensation, addresses and other sensitive HR data). An empty page means the end. Namely API: GET /profiles (lim
- `namely_get_profile`: Get one employee's full profile by id: personal and job data, manager, groups, teams and the custom fields the token may see (can include compensation and other sensitive HR data). Namely API: GET /profiles/{id}.
- `namely_list_profile_fields`: List the fields of the employee profile as configured at this company (standard and custom), with their labels, sections and the valid format of each value. Namely API: GET /profiles/fields.
- `namely_list_groups`: List all groups (departments, office locations and other company groups). Every group belongs to one group type. Namely API: GET /groups.
- `namely_get_group`: Get one group by id, with the profiles (members) linked to it. Namely API: GET /groups/{id}.
- `namely_list_group_types`: List the group types (the containers of groups, such as Department or Office). Namely API: GET /group_types.
- `namely_list_teams`: List all teams with their team categories. Namely API: GET /teams.
- `namely_get_team`: Get one team by id, with the profiles (members) linked to it. Namely API: GET /teams/{id}.
- `namely_list_job_titles`: List all job titles; each belongs to one job tier. Namely API: GET /job_titles.
- `namely_list_job_tiers`: List all job tiers (the levels that group job titles). Namely API: GET /job_tiers.
- `namely_list_events`: List events of the company home feed (announcements, birthdays, work anniversaries, new arrivals), newest first by default, with limit and after (an event id) for paging. Namely API: GET /events.
- `namely_list_event_comments`: List the comments on a feed event. Namely API: GET /events/{event-id}/comments.
- `namely_get_report`: Run a saved Namely report by id and return its columns and rows (live data; each row is a list in column order). Find the id in the URL of the report in Namely. Reports can contain sensitive HR data such as salary history. Namely API: GET /reports/{id}.
- `namely_update_profile`: Change standard fields of an employee profile (name, emails, start date, status, manager, job title). WRITES live HR data. Send only the fields to change. Setting user_status to pending needs a personal_email. Namely API: PUT /profiles/{id}.
- `namely_create_announcement`: Post an announcement to the company home feed, visible to every employee. Markdown; to mention a person write [Full Name](/people/<profile_id>). With is_appreciation, mentioned people are appreciated. email_all=true ALSO EMAILS every active employee at their company address (needs the permission) and cannot be undone: set it only when the user explicitly asks. Namely API: POST /events.
- `namely_create_event_comment`: Add a comment to a feed event, posted as the token's user and visible to employees who see the event. Markdown; mention a person with [Full Name](/people/<profile_id>). Namely API: POST /events/{id}/comments.

## FAQ

### How do I add Namely MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http namely https://namely.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/namely-mcp-by-usefulapi
