ChartHop Search MCP

A small MCP server that searches the 1Password/AgileBits employee directory (ChartHop). It mirrors the ChartHop piece of the Internal1P Alfred workflow: under the hood it calls GET {host}/alfred/charthop?q={query} with a bearer token and returns the matching people.

Tool

search_people(query)

Search the directory by name (or partial name). Returns a list of people, each with:

Returns an empty list when there are no matches.

Related MCP server: contacts-mcp

Configuration

Configuration is read from environment variables:

Supply your own token. Do not reuse a token belonging to another person — it is tied to their account.

Setup

uv sync

Register with an MCP client

Add this to your client's MCP config (e.g. Claude Desktop claude_desktop_config.json, or via claude mcp add for Claude Code):

{
  "mcpServers": {
    "charthop": {
      "command": "uv",
      "args": [
        "--directory", "/Users/jeremybeker/development/charthup_mcp",
        "run", "charthop-mcp"
      ],
      "env": {
        "CHARTHOP_TOKEN": "<your-jwt>"
      }
    }
  }
}

Verify

Smoke-test the tool logic directly (no MCP client needed):

CHARTHOP_TOKEN=<your-jwt> uv run python -c \
  "from charthop_mcp.server import search_people; import json; print(json.dumps(search_people('jeremy'), indent=2))"

Or inspect it interactively with the MCP Inspector:

uv run mcp dev src/charthop_mcp/server.py