Lattice MCP 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