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
- In ChatGPT settings, open Connectors (Apps) and turn on developer mode if your plan asks for it.
- Create a connector: name Hypha Desk, URL
https://hyphadesk.com/mcp, authentication OAuth. - Sign in with your Hypha Desk account and pick the organisation.
Custom GPTs, Zapier, Make, n8n (REST API)
- Create an API key in Hypha Desk → Settings → API keys.
- Import
https://hyphadesk.com/api/v1/openapi.jsonas the schema (GPT Actions), or call the endpoints in the API docs. - 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
- In Copilot Studio, add a tool of type Model Context Protocol (MCP) to your agent.
- Server URL
https://hyphadesk.com/mcp; authentication API key, headerAuthorization, valueBearer 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.