goodtime-mcp

GoodTime MCP server for Claude and other MCP-compatible clients.

This package exposes GoodTime public API resources as MCP tools over stdio.

What This Does

After setup, your AI assistant can securely read and update GoodTime interview scheduling data and answer questions in plain language.

Examples:

• "How many interviews are scheduled to happen for today?"
• "Find and show me canceled interviews from last week."
• "How many tags do we have in the system?"
• "Add the [tag name] to the [interviewer name]."

Install

Recommended:

npm install -g goodtime-mcp

Or run directly without a global install:

npx goodtime-mcp

Requirements

• Node.js 18+
• A GoodTime API key (ask your admin if you do not have one)

Configure Your MCP Client

Set GOODTIME_API_KEY in your MCP server configuration.

Quick Setup (Copy/Paste)

Use this if you are not sure which option to pick:

Example mcpServers entry:

{
  "mcpServers": {
    "goodtime": {
      "command": "goodtime-mcp",
      "env": {
        "GOODTIME_API_KEY": "your-goodtime-api-key"
      }
    }
  }
}

If your client does not resolve globally installed binaries, use npx:

{
  "mcpServers": {
    "goodtime": {
      "command": "npx",
      "args": ["-y", "goodtime-mcp"],
      "env": {
        "GOODTIME_API_KEY": "your-goodtime-api-key"
      }
    }
  }
}

Last Step

Restart your MCP client (for example, restart Claude) after saving config.

How To Check It Works

Ask your assistant something like:

• "How many interviews are scheduled to happen next week?"
• "Show me the tags that interviewer [Name] has."

If setup is correct, the assistant should return live GoodTime data.

Troubleshooting

• "Command not found: goodtime-mcp": use the npx config shown above.
• "Unauthorized" or no data: confirm your GOODTIME_API_KEY is valid.
• Still not working: restart the client and try again.

Available Tools

• list_interviews
• get_interview
• list_contacts
• get_contact_tags
• list_tags
• get_tag
• list_tag_types
• get_tag_type
• list_tags_by_type
• create_tag
• create_tag_type
• update_tag
• update_tags
• update_tag_type
• update_contact
• update_contacts
• add_contact_tags
• remove_contact_tag

Privacy Policy

goodtime-mcp is a stateless bridge between your MCP client (e.g., Claude) and GoodTime's public API.

• Who can use this: A GOODTIME_API_KEY is only issued to organizations with an active GoodTime customer account. This server does not create any new data relationship — it uses the same API access already governed by your organization's existing agreement with GoodTime.
• What data this server accesses: Contacts, tag, tag type, and interview data from your organization's GoodTime account, scoped to whatever your GOODTIME_API_KEY has access to.
• What this server stores: Nothing. This server does not log, cache, or persist any data anywhere. Every tool call forwards a request live to GoodTime's public API and returns the response — no data is retained by this server between requests or after your MCP client session ends.
• How your API key is used: Your GOODTIME_API_KEY is used only to authenticate requests to GoodTime's public API on your behalf. It is read from your local environment/MCP client configuration and is not transmitted anywhere other than to GoodTime's API.
• Third parties: None. This server communicates only with GoodTime's public API — no analytics, logging, or other third-party services are involved in its operation.
• Your organization's GoodTime data: The data this server reads and writes is "Customer Data" belonging to your organization. As GoodTime's own privacy policy states, processing of Customer Data is governed by the contract between your organization and GoodTime, not by GoodTime's general privacy policy. See:
  • GoodTime Privacy Policy (https://goodtime.io/privacy-policy/) — general policy for GoodTime's website and accountholder data
  • GoodTime Master Service Agreement (https://goodtime.io/msa/) — the governing contract for how Customer Data (contacts, tags, interviews) is processed
  • GoodTime Security (https://goodtime.io/security/) — encryption, data ownership, subprocessors, and incident reporting practices
• Questions or concerns: Contact [email protected] for privacy or security questions about GoodTime's platform, or see Support below for issues specific to this MCP server.

Support

For issues or questions related to this MCP server, contact [email protected].

Developer Docs

Internal development setup and full tool/parameter reference are in docs/DEVELOPMENT.md.