Connect an AI tool to Hypha Desk

Hypha Desk is an MCP server at https://hyphadesk.com/mcp. Connected tools read and write as you: work items, clients, Important Context, documents, todos, ideas and your Inbox. Documents are the Word (.docx) and PDF files attached to a work item's or client's Important Context timeline. They see only what you see and cannot delete anything.

Work items were called projects, and before that initiatives. The work-item tools (list_work_items, get_work_item, create_work_item, update_work_item, list_work_types) return work_item / work_items with type (the id) and type_name; the older names (list_projects, list_initiatives, …) still work and return their old field names.

ChatGPT
  1. In ChatGPT settings, open Connectors (Apps) and turn on developer mode if your plan asks for it.
  2. Create a connector: name Hypha Desk, URL https://hyphadesk.com/mcp, authentication OAuth.
  3. Sign in with your Hypha Desk account and pick the organisation.
Then ask things like “What's open on the Acme rebuild?” or “Add to Acme's Important Context: the client approved the site map”.
Custom GPTs, Zapier, Make, n8n (REST API)
  1. Create an API key in Hypha Desk → Settings → API keys.
  2. Import https://hyphadesk.com/api/v1/openapi.json as the schema (GPT Actions), or call the endpoints in the API docs.
  3. Authentication: API key, type Bearer, value hd_your_key.
Gemini CLI · ~/.gemini/settings.json
{
  "mcpServers": {
    "hyphadesk": {
      "httpUrl": "https://hyphadesk.com/mcp",
      "headers": { "Authorization": "Bearer hd_your_key" }
    }
  }
}
Microsoft Copilot
  1. In Copilot Studio, add a tool of type Model Context Protocol (MCP) to your agent.
  2. Server URL https://hyphadesk.com/mcp; authentication API key, header Authorization, value Bearer hd_your_key.
VS Code (GitHub Copilot agent mode) · .vscode/mcp.json
{
  "servers": {
    "hyphadesk": {
      "type": "http",
      "url": "https://hyphadesk.com/mcp",
      "headers": { "Authorization": "Bearer hd_your_key" }
    }
  }
}
Cursor, Windsurf and other MCP tools
{
  "mcpServers": {
    "hyphadesk": {
      "url": "https://hyphadesk.com/mcp",
      "headers": { "Authorization": "Bearer hd_your_key" }
    }
  }
}
Any tool that supports remote MCP servers works. Tools that support MCP sign-in (OAuth) can leave out headers and sign in with your Hypha Desk account instead.
API keys come from Hypha Desk → Settings → API keys. A key acts as you in one organisation; remove it there if it may have leaked. Changes made this way show “(via MCP)” in the activity log.

Prefer plain HTTP? See the REST API.