Namely MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.16.3Updated Nov 5, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Hosted Namely HRIS connector that lets an assistant read employee profiles, org structure, jobs and reports, and make limited profile and feed updates.

What you can do
  • Read employee profiles, including your own, with paging, filters and configurable profile fields
  • Browse org structure: groups, group types, teams, job titles and job tiers, with members
  • Read the company home feed: events and their comments
  • Run saved Namely reports and return their columns and rows
  • Write to HR data: update standard profile fields, post announcements to the feed, comment on events
  • Check usage, request a feature, upgrade or cancel the subscription
When to use it
Useful when an assistant should answer questions about a company's people data in Namely — who reports to whom, department rosters, start dates, anniversaries, job titles — or make small HR updates and feed posts without opening Namely.
Requirements
A remote MCP endpoint added by URL only; no API key or Authorization header in the client config. Sign-in uses OAuth, and the login page asks for the Namely site name (for example acme for acme.namely.com) and a Namely Personal Access Token. A Namely account with permission for the data and actions used is required.
Before you install
Write tools change live HR data: namely_update_profile edits employee records, namely_create_announcement posts company-wide and with email_all also emails every active employee, and namely_create_event_comment posts as your user. Profiles and reports can expose sensitive HR data such as compensation and salary history. Your Namely token is entered on the provider's login page. Paid plans cost money and are billed through a Stripe checkout link; the free plan is capped at 50 calls a month.

Installation

In SourceWeft

  1. Open Namely MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fnamely/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Namely MCP by usefulapi

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

Live endpoint: https://namely.usefulapi.io/mcp · Homepage: https://usefulapi.io/namely

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://namely.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http namely https://namely.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "namely": {      "url": "https://namely.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Namely credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/namely/

On first connect you'll enter your Namely site name (acme for acme.namely.com) and a Personal Access Token.

Tools

ToolTypeWhat it does
namely_get_mereadGet my profile
namely_list_profilesreadList employee profiles
namely_get_profilereadGet employee profile
namely_list_profile_fieldsreadList profile fields
namely_list_groupsreadList groups
namely_get_groupreadGet group
namely_list_group_typesreadList group types
namely_list_teamsreadList teams
namely_get_teamreadGet team
namely_list_job_titlesreadList job titles
namely_list_job_tiersreadList job tiers
namely_list_eventsreadList feed events
namely_list_event_commentsreadList event comments
namely_get_reportreadGet report
namely_update_profilewriteUpdate employee profile
namely_create_announcementwritePost announcement
namely_create_event_commentwriteComment on event
namely_usage_statusmetaUsage status (free-tier meter)
namely_request_featuremetaRequest a missing feature
namely_upgrademetaUpgrade to Pro or Pro+
namely_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with namely_upgrade (it returns a Stripe Checkout link). Cancel any time with namely_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running namely_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Namely.

Source: servers/namely/README.md at commit 4046075

Tools

17

namely_get_me

Get my profile

Get the profile of the user the connected token belongs to (name, email, job title, manager, access role). Namely API: GET /profiles/me.

Takes no parameters.

namely_list_profiles

List employee 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 (limit 100 requests per minute).

Parameterspagesortemailformatper_pagejob_titlelast_namefirst_namereports_touser_statuspersonal_email

namely_get_profile

Get employee 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}.

Parametersidrequired

namely_list_profile_fields

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.

Takes no parameters.

namely_list_groups

List groups

List all groups (departments, office locations and other company groups). Every group belongs to one group type. Namely API: GET /groups.

Takes no parameters.

namely_get_group

Get group

Get one group by id, with the profiles (members) linked to it. Namely API: GET /groups/{id}.

Parametersidrequired

namely_list_group_types

List group types

List the group types (the containers of groups, such as Department or Office). Namely API: GET /group_types.

Takes no parameters.

namely_list_teams

List teams

List all teams with their team categories. Namely API: GET /teams.

Takes no parameters.

namely_get_team

Get team

Get one team by id, with the profiles (members) linked to it. Namely API: GET /teams/{id}.

Parametersidrequired

namely_list_job_titles

List job titles

List all job titles; each belongs to one job tier. Namely API: GET /job_titles.

Takes no parameters.

namely_list_job_tiers

List job tiers

List all job tiers (the levels that group job titles). Namely API: GET /job_tiers.

Takes no parameters.

namely_list_events

List feed 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.

Parameterstypeafterlimitorderprofile_id

namely_list_event_comments

List event comments

List the comments on a feed event. Namely API: GET /events/{event-id}/comments.

Parametersevent_idrequired

namely_get_report

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}.

Parametersidrequired

namely_update_profile

Update employee 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}.

Parametersidrequiredemailjob_titlelast_namefirst_namereports_tostart_dateuser_statuspersonal_email

namely_create_announcement

Post 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.

Parameterscontentrequiredemail_allis_appreciation

namely_create_event_comment

Comment on event

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.

Parameterscontentrequiredevent_idrequired

Version history

14
  1. v1.16.3LatestNov 5, 2026
  2. v1.16.2Nov 5, 2026
  3. v1.16.1Nov 4, 2026
  4. v1.16.0Nov 3, 2026
  5. v1.15.1Nov 3, 2026
  6. v1.14.0Nov 1, 2026
  7. v1.12.0Oct 31, 2026
  8. v1.11.0Oct 31, 2026
  9. v1.10.2Oct 30, 2026
  10. v1.10.0Oct 30, 2026
  11. v1.5.0Oct 26, 2026
  12. v1.2.3Oct 25, 2026
  13. v1.2.0Oct 25, 2026
  14. v1.1.0Oct 24, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably that lets an assistant inspect realtime channels, presence and usage stats, publish messages, and review app configuration.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 5, 2026

ProofHub MCP by usefulapi

io.usefulapiOfficial publisher

Hosted ProofHub connector that lets an assistant read projects, tasks, comments, people and time entries, and create tasks or comments.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 5, 2026

MyOnlineStore MCP by usefulapi

io.usefulapiOfficial publisher

Hosted, read-only MCP server that lets an assistant browse one MyOnlineStore shop's orders, products, categories, customers, discounts and newsletter…

Streamable HTTPWeb executable
Business & Commerce20 toolsNov 5, 2026

Jostle MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Jostle Tasks: read users, presets, tasks and comments, and create or update tasks and post comments as your own user.

Streamable HTTPWeb executable
Communication & Collaboration7 toolsNov 5, 2026

ExpenseOnDemand MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for ExpenseOnDemand: read accounting exports, payroll totals and master data, and add, update or deactivate employees, customers and cost…

Streamable HTTPWeb executable
Business & Commerce15 toolsNov 5, 2026