# Workast MCP server

> Lets an AI client manage tasks, projects, documents, and meetings within Workast spaces.

- Repository: https://github.com/workast/mcp
- Page: https://hostedmcp.org/servers/workast/mcp
- Transport: remote
- Stars: 1
- License: MIT
- Latest version: 1.4.1

## Install

### Claude Code

```sh
claude mcp add --transport http mcp https://mcp.workast.com/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.workast.com/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.workast.com/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.workast.com/mcp"}'
```

### Codex

```sh
codex mcp add mcp --url https://mcp.workast.com/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
url = "https://mcp.workast.com/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http mcp https://mcp.workast.com/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.workast.com/mcp",
      "type": "http"
    }
  }
}
```

## Tools (32)

- `workast_search_tasks`
- `workast_retrieve_tasks`
- `workast_create_tasks`
- `workast_create_personal_tasks`
- `workast_create_subtasks`
- `workast_update_tasks`
- `workast_complete_tasks`
- `workast_create_comment`
- `workast_list_task_activity`
- `workast_list_spaces`
- `workast_retrieve_space`
- `workast_create_space`
- `workast_update_space`
- `workast_update_space_readme`
- `workast_list_space_participants`
- `workast_add_space_participants`
- `workast_about_me`
- `workast_list_coworkers`
- `workast_list_notes`
- `workast_retrieve_note`
- `workast_create_note`
- `workast_update_note`
- `workast_list_forms`
- `workast_create_form`
- `workast_list_meetings`
- `workast_retrieve_meeting`
- `workast_list_fields`
- `workast_create_field`
- `workast_update_field`
- `workast_list_reports`
- `workast_retrieve_report`
- `workast_ping`

## FAQ

### How do I add Workast to Cursor?

You can add it by putting the server configuration in your ~/.cursor/mcp.json or .cursor/mcp.json file.

### Can I use Workast with an agent that cannot show a sign-in prompt?

Yes, you can use headless access by creating an API key in your Workast account and providing it in the Authorization header.

### What kind of tasks can the AI manage?

The AI can create, search, update, complete, comment on, and split tasks into subtasks, including personal tasks.

### How does the server ensure it follows project rules?

The server includes a Workast skill that allows the client to read a space's README to follow specific lists, fields, and formats.
