Tability

You can run a dedicated MCP server to let AI assistants interact with your Tability workspace, so you can manage OKRs, track progress, and update checkins through natural language. This guide shows you how to install, configure, and use the server with your preferred MCP client.

How to use

Connect your MCP client to the Tability MCP Server to start issuing natural-language requests that map to Tability API endpoints. You can ask the assistant to identify your user, list plans, drill into objectives and outcomes, create progress updates, or search for initiatives. Use exact action prompts such as requesting current user details, listing plans, checking plan progress, creating checkins, or searching for initiatives. The server exposes 27 tools that cover authentication, workspace details, memberships, plans, objectives, outcomes, initiatives, checkins, and search capabilities.

How to install

# Clone the repository
git clone https://github.com/luquimbo/tability-mcp.git
cd tability-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuration

Configure your MCP clients to connect to the Tability MCP Server using one or more stdio configurations. You can run the server locally and point your client to the executed node script.

{
  "mcpServers": {
    "tability_desktop": {
      "command": "node",
      "args": ["/absolute/path/to/tability-mcp/dist/index.js"],
      "env": {
        "TABILITY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

{
  "mcpServers": {
    "tability_code": {
      "command": "node",
      "args": ["./dist/index.js"],
      "cwd": "/path/to/tability-mcp",
      "env": {
        "TABILITY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Additional guidance

Environment variables you need are shown in the configuration blocks. In particular, you must provide your Personal API token with the environment variable TABILITY_API_TOKEN. Keep this token secure and do not commit it to version control.

If you run into issues starting the server, verify that your token is correct, the build completed successfully, and the path to the runtime script matches what you configured in your MCP client.

Available tools

tability_whoami

Get the authenticated user profile from your Tability workspace.

tability_get_workspace

Retrieve details about your Tability workspace.

tability_list_memberships

List all workspace members with filtering options.

tability_get_membership

Fetch details for a specific workspace member.

tability_get_membership_manager

Get a member's manager.

tability_get_membership_direct_reports

List direct reports for a member.

tability_update_membership

Update a member's role or manager.

tability_delete_membership

Remove a member from the workspace.

tability_add_memberships

Invite new users to the workspace.

tability_add_readonly_memberships

Add read-only users (free tier).

tability_list_plans

List all plans with pagination.

tability_get_plan

Get details for a specific plan.

tability_list_objectives_for_plan

Retrieve objectives within a plan.

tability_get_objective

Get details for a specific objective.

tability_list_outcomes_for_plan

List outcomes under a plan.

tability_list_outcomes_for_objective

List outcomes under an objective.

tability_get_outcome

Get details for a specific outcome.

tability_list_initiatives_for_plan

List initiatives within a plan.

tability_list_initiatives_for_outcome

List initiatives under an outcome.

tability_get_initiative

Get details for a specific initiative.

tability_list_checkins_for_outcome

Get checkin history for an outcome.

tability_get_checkin

Get details for a specific checkin.

tability_create_checkin

Create a new progress update (checkin).

tability_search_plans

Search plans with filters.

tability_search_objectives

Search objectives with filters.

tability_search_outcomes

Search outcomes with filters.

tability_search_initiatives

Search initiatives with filters.