# Edworking — how to use (mcp.ai)

Connect your Edworking account and use 12 tools for project management straight from your AI agent. Connect with your own API key. Edworking is a collaborative workspace for managing projects, tasks, files, messages, notifications, and time tracking.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_edworking?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `edworking_add_time_entry`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/edworking`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/edworking/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/edworking/add/time/entry` — Record a duration against a task at a specified start time.
  - body: { task_id: string, duration: integer, start_time: string, description?: string }
- `POST https://api.mcp.ai/api/edworking/create/task` — Create a named task in an Edworking project.
  - body: { name: string, project_id: string }
- `POST https://api.mcp.ai/api/edworking/delete/task` — Permanently delete one Edworking task. This operation is destructive and cannot be undone.
  - body: { task_id: string }
- `POST https://api.mcp.ai/api/edworking/get/task` — Get one task with its project, state, assignees, and time entries.
  - body: { task_id: string }
- `POST https://api.mcp.ai/api/edworking/list/folders` — List folders in an Edworking project, optionally restricted to children of a parent folder.
  - body: { project_id: string, parent_folder_id?: string }
- `POST https://api.mcp.ai/api/edworking/list/messages` — List Edworking's message/activity records for one project from a zero-based offset. Live provider responses may contain only activity records and do not reliably expose text accepted by SEND_MESSAGE.
  - body: { offset?: integer, project_id: string }
- `POST https://api.mcp.ai/api/edworking/list/projects` — List the Edworking projects available to the connected account, returning IDs needed by project-scoped tools.
- `POST https://api.mcp.ai/api/edworking/list/states` — List the workflow states configured for an Edworking project for inspection.
  - body: { project_id: string }
- `POST https://api.mcp.ai/api/edworking/list/tasks` — List tasks, optionally within one Edworking project, with concise status and tracking information.
  - body: { project_id?: string }
- `POST https://api.mcp.ai/api/edworking/remove/time/entry` — Permanently remove one tracked-time entry by ID. This destructive action cannot be undone.
  - body: { time_entry_id: string }
- `POST https://api.mcp.ai/api/edworking/send/message` — Irreversibly send a text message to an Edworking project. Edworking provides no verified message deletion operation, and project message listing may not return the sent text; use the returned message 
  - body: { body: string, project_id: string }
- `POST https://api.mcp.ai/api/edworking/update/task` — Update an existing task's name within its Edworking project.
  - body: { name: string, task_id: string, project_id: string }

## Example prompts
- "What can I do in Edworking?"
- "Show me a summary of my Edworking account"

## More
- Page: https://mcp.ai/edworking
- Agent spec (llms.txt): https://mcp.ai/edworking/llms.txt
- Postman collection: https://mcp.ai/edworking/postman.json