Lattice HQ

A Model Context Protocol (MCP) server for Lattice HQ that enables AI models to interact with your Lattice performance management platform.

This MCP server provides access to the following Lattice HQ capabilities:

- Get all users in the organization
- Get specific user details
- Get direct reports for any user
- Get current user information

- Get all goals in the organization
- Get specific goal details
- Get goals for a specific user

- Get all review cycles
- Get specific review cycle details
- Get reviewees for a review cycle

- Get all feedback
- Get specific feedback details

- Get all departments
- Get specific department details

- Get all updates
- Get specific update details

- Node.js 18 or higher
- Lattice HQ account with API access
- Lattice API token

No installation required! Just use npx to run the latest version:

LATTICE_API_URL=https://your-company.latticehq.com npx lattice-hq-mcp-server --api-key=YOUR-TOKEN --stdio

# Install globally npm install -g lattice-hq-mcp-server # Run the server LATTICE_API_URL=https://your-company.latticehq.com lattice-hq-mcp-server --api-key=YOUR-TOKEN --stdio

# Clone the repository git clone https://github.com/cyrilnoah1/lattice-hq-mcp.git cd lattice-hq-mcp # Install dependencies npm install # Build the project npm run build # Run the server npm run dev

- Log in to your Lattice HQ account
- Go to Settings → Integrations → API (if available)
- Generate a new API token
- Copy the token and add it to your configuration

If you don't see "Integrations" under Settings, this usually means:

- Your plan doesn't include API access (typically Enterprise only)
- You don't have admin permissions
- API access needs to be enabled for your account

- Email:support@lattice.com
- Request API access for your account/plan

export LATTICE_API_TOKEN=your_token_here export LATTICE_API_URL=https://your-company.latticehq.com lattice-hq-mcp-server --stdio

LATTICE_API_URL=https://your-company.latticehq.com lattice-hq-mcp-server --api-key=your_token_here --stdio

{ "mcpServers": { "lattice-hq": { "command": "npx", "args": ["-y", "lattice-hq-mcp-server", "--api-key=YOUR-TOKEN", "--stdio"], "env": { "LATTICE_API_URL": "https://your-company.latticehq.com" } } } }

{ "mcpServers": { "lattice-hq": { "command": "node", "args": ["/path/to/lattice-hq-mcp/dist/index.js"], "env": { "LATTICE_API_URL": "https://your-company.latticehq.com", "LATTICE_API_TOKEN": "your_api_token_here" } } } }

This server follows the standard MCP protocol and can be used with any MCP-compatible client.

- lattice_get_users- Get all users
- lattice_get_user- Get user by ID
- lattice_get_user_direct_reports- Get user's direct reports
- lattice_get_me- Get current user

- lattice_get_goals- Get all goals
- lattice_get_goal- Get goal by ID
- lattice_get_user_goals- Get goals for a user

- lattice_get_review_cycles- Get all review cycles
- lattice_get_review_cycle- Get review cycle by ID
- lattice_get_review_cycle_reviewees- Get reviewees for a cycle

- lattice_get_feedbacks- Get all feedback
- lattice_get_feedback- Get feedback by ID

- lattice_get_departments- Get all departments
- lattice_get_department- Get department by ID

- lattice_get_updates- Get all updates
- lattice_get_update- Get update by ID

You can configure the server using environment variables:

- LATTICE_API_TOKEN: Your Lattice API token (required)
- LATTICE_API_URL: Lattice API base URL (required)

# Install dependencies npm install # Build in watch mode npm run watch # Run development server npm run dev # Build for production npm run build

- Fork the repository
- Create your feature branch (git checkout -b feature/amazing-feature)
- Commit your changes (git commit -m 'Add some amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

This project is licensed under the MIT License - see theLICENSEfile for details.
- Check theGitHub Issues
- Create a new issue with details about your problem
- Include your Node.js version, operating system, and any error messages

You built it, now get users! GoToMarket MCP server