Lattice Server

An MCP (Model Context Protocol) server that exposes the Lattice Talent API as tools — so AI assistants like Claude can read and manage your people data, goals, feedback, reviews, and more.

Prerequisites

• Node.js 18+
• A Lattice API key (generate one from your Lattice admin dashboard under Integrations → API)

Quick Start

1. Clone & install

git clone https://github.com/EoinFalconer/lattice-mcp.git
cd lattice-mcp
npm install

2. Build

npm run build

3. Configure your MCP client

Add the server to your MCP client configuration. For example, in Claude Code (~/.claude/settings.json or project-level .mcp.json):

{
  "mcpServers": {
    "lattice": {
      "command": "node",
      "args": ["/absolute/path/to/lattice-mcp/dist/index.js"],
      "env": {
        "LATTICE_API_KEY": "your-api-key-here"
      }
    }
  }
}

For EMEA data residency, add "LATTICE_REGION": "emea" to the env block.

Environment Variables

Variable	Required	Default	Description
LATTICE_API_KEY	Yes	—	Your Lattice API key
LATTICE_REGION	No	us	Data residency region: us or emea

Available Tools (30)

Users

Tool	Description
get_current_user	Get the authenticated user
get_user	Get a user by ID
list_users	List all users (paginated)
get_user_direct_reports	Get a user's direct reports
get_user_custom_attributes	Get custom attributes for a user
get_user_goals	Get goals for a user
get_user_tasks	Get tasks for a user

Goals

Tool	Description
get_goal	Get a goal by ID
list_goals	List goals, optionally filtered by state
create_goal	Create a new goal
update_goal	Update an existing goal (full PUT)

Goal Updates

Tool	Description
create_goal_update	Add a progress update to a goal
get_goal_updates	Get updates for a specific goal
list_all_goal_updates	Get all goal updates across goals

Departments

Tool	Description
get_department	Get a department by ID
list_departments	List all departments

Feedback

Tool	Description
get_feedback	Get a feedback entry by ID
list_feedback	List all continuous feedback

Review Cycles

Tool	Description
get_review_cycle	Get a review cycle by ID
list_review_cycles	List all review cycles
get_review_cycle_reviewees	Get reviewees for a cycle
get_review_cycle_reviews	Get reviews for a cycle

Reviewees

Tool	Description
get_reviewee	Get a reviewee by ID
get_reviewee_reviews	Get reviews for a reviewee

Questions

Tool	Description
get_question	Get a review question by ID
get_question_revision	Get a question revision by ID

Other

Tool	Description
get_competency	Get a competency by ID
get_custom_attribute	Get a custom attribute definition
get_custom_attribute_value	Get a custom attribute value
get_tag / list_tags	Get or list tags
get_update / list_updates	Get or list updates
get_task	Get a task by ID

API Notes

• Pagination — Cursor-based. Use limit (1–100) and startingAfter (the endingCursor from the previous response).
• Rate limits — 240 requests/minute. 429 responses include a Retry-After header.
• Base URLs — US: api.latticehq.com / EMEA: api.emea.latticehq.com

License

ISC