# Developer Platform

You want to integrate Taskade into your app, automate your workflows, or connect your AI tools. This page gets you started fast. Many teams build their app visually with [Taskade Genesis](https://www.taskade.com/create) first, then extend it with the API.

## Integration Surface at a Glance

```mermaid
graph TB
    subgraph "Your Application"
        APP[Your App / Script / Agent]
    end

    subgraph "Integration Surface"
        API1[REST API v1<br/>RESTful + OAuth 2.0]
        API2[Action API v2<br/>RPC + OAuth 2.0]
        MCP_IN["@taskade/mcp-server<br/>Inbound MCP, npm"]
        MCP_HOST[Hosted MCP<br/>taskade.com/mcp]
        MCP_OUT[MCP Connectors<br/>Outbound to 31+ services]
        WEBHOOK[Webhooks<br/>Automation triggers]
    end

    subgraph "Taskade Workspace"
        PROJECTS[Projects & Tasks]
        AGENTS[AI Agents<br/>with LTM]
        AUTOMATIONS[Automations]
        MEDIA[Media & Bundles]
        APP_SRC[Genesis App Source]
    end

    APP --> API1
    APP --> API2
    APP --> MCP_IN
    APP --> MCP_HOST
    WEBHOOK --> APP

    MCP_IN --> API1
    MCP_HOST --> APP_SRC
    MCP_OUT --> AGENTS

    API1 --> PROJECTS
    API1 --> AGENTS
    API2 --> AGENTS
    API2 --> MEDIA
    API1 --> AUTOMATIONS

    AGENTS -.writes LTM.-> PROJECTS
```

## I Want To...

| I want to...                                                        | Use                                                                                                                             |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Write tasks, manage assignees/dates/fields (full CRUD)              | [REST API v1](/apis-and-developer/comprehensive-api-guide.md)                                                                   |
| Prompt agents, manage agents, export/import bundles                 | [Action API v2](/apis-and-developer/api-v2-reference.md)                                                                        |
| Hit endpoints from any language                                     | [REST API v1](/apis-and-developer/comprehensive-api-guide.md) + [Action API v2](/apis-and-developer/api-v2-reference.md)        |
| Expose Taskade data to Claude Desktop, Cursor, or other MCP clients | [Workspace MCP](/apis-and-developer/workspace-mcp.md) + [Advanced](/apis-and-developer/workspace-mcp/workspace-mcp-advanced.md) |
| Give a Taskade agent third-party capabilities                       | [MCP Connectors](/apis-and-developer/workspace-mcp/workspace-mcp-advanced.md#mcp-connectors)                                    |
| Edit Genesis app source code from your IDE                          | [Hosted MCP (Genesis App)](/apis-and-developer/workspace-mcp/genesis-app-mcp.md)                                                |
| Receive real-time events in your app                                | [Webhooks](/apis-and-developer/webhooks.md)                                                                                     |
| Understand long-term memory                                         | [Long-Term Memory](/apis-and-developer/long-term-memory.md)                                                                     |
| Build agents that run without prompting                             | [Autonomous Agents](/apis-and-developer/autonomous-agents.md)                                                                   |
| Automate workflows without code                                     | [Automations Engine](/automations/automation.md)                                                                                |
| Browse community apps and templates                                 | [taskade.com/community](https://www.taskade.com/community)                                                                      |

## Get Your API Key

You need a **Personal Access Token** to authenticate with every Taskade developer tool — the REST API, MCP Server, and SDK all use it.

1. Go to [taskade.com/settings/api](https://www.taskade.com/settings/api).
2. Click **Create new token** and give it a descriptive name.
3. Copy the token and store it somewhere safe. You will not be able to see it again.

{% hint style="warning" %}
Treat your API token like a password. Never commit it to version control or share it publicly.
{% endhint %}

## Developer Resources

| Resource                                                                                | Description                                                                          |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| [REST API v1 Reference](/apis-and-developer/comprehensive-api-guide.md)                 | The complete, stable RESTful API — full task CRUD, per-endpoint docs                 |
| [Action API v2 Reference](/apis-and-developer/api-v2-reference.md)                      | The newer action-based (RPC) API — agent prompting, bundles, lifecycle               |
| [Authentication Guide](/apis-and-developer/authentication.md)                           | Personal access tokens and OAuth 2.0 (PKCE) flows                                    |
| [Workspace MCP](/apis-and-developer/workspace-mcp.md)                                   | Run `@taskade/mcp-server` to connect Claude Desktop, Cursor, and Claude Code         |
| [Workspace MCP — Advanced](/apis-and-developer/workspace-mcp/workspace-mcp-advanced.md) | Multi-client setup, troubleshooting, security                                        |
| [Hosted MCP — Genesis App (Beta)](/apis-and-developer/workspace-mcp/genesis-app-mcp.md) | Edit your Genesis app's source from your IDE via the remote `taskade.com/mcp` server |
| [MCP Connectors](/apis-and-developer/mcp-connectors.md)                                 | Give Taskade agents 31+ third-party tools (outbound MCP)                             |
| [Webhooks](/apis-and-developer/webhooks.md)                                             | Trigger automations from external events; call out to any API                        |
| [Bundles & App Kits](/apis-and-developer/bundles.md)                                    | Import/export full Genesis apps as portable `.tsk` bundles                           |
| [Long-Term Memory](/apis-and-developer/long-term-memory.md)                             | Memory-as-Projects architecture — editable, queryable, API-addressable               |
| [Autonomous Agents](/apis-and-developer/autonomous-agents.md)                           | Automations, orchestration, cross-agent invocation patterns                          |
| [TypeScript SDK (Preview)](/apis-and-developer/sdk-quickstart.md)                       | Generated client for v2 — not yet on public npm; use the REST API meanwhile          |

{% hint style="info" %}
**New to Taskade?** Start with the [Quick Start Guide](/quick-start/getting-started.md) to understand workspaces, projects, and tasks before diving into the API.
{% endhint %}

## Base URLs

Taskade ships **two** public HTTP APIs, both authenticated with the same token:

| API                                                           | Base URL                         | Style                                 | Use it for                                      |
| ------------------------------------------------------------- | -------------------------------- | ------------------------------------- | ----------------------------------------------- |
| [REST API v1](/apis-and-developer/comprehensive-api-guide.md) | `https://www.taskade.com/api/v1` | RESTful (`GET`/`POST`/`PUT`/`DELETE`) | Full task CRUD, assignees, dates, notes, fields |
| [Action API v2](/apis-and-developer/api-v2-reference.md)      | `https://www.taskade.com/api/v2` | Action / RPC (`POST /{operation}`)    | Prompting agents, agent lifecycle, bundles      |

Include your token in the `Authorization` header:

```bash
# v1 (RESTful)
curl -H "Authorization: Bearer your_api_key_placeholder" \
     https://www.taskade.com/api/v1/me/projects

# v2 (action-based — every call is a POST)
curl -X POST https://www.taskade.com/api/v2/listMyProjects \
     -H "Authorization: Bearer your_api_key_placeholder" \
     -H "Content-Type: application/json" -d '{}'
```

## What You Can Build

* **Custom dashboards** that pull data from Taskade workspaces and projects
* **CI/CD integrations** that create tasks or update statuses on deploy
* **AI assistants** that manage tasks and agents through the MCP Server
* **Internal tools** that connect Taskade to your company's systems
* **Automation bots** that react to events and keep projects in sync

{% hint style="success" %}
**Need help?** Join the [Taskade community](https://www.taskade.com/community) or reach out to support at [taskade.com/contact](https://www.taskade.com/contact).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.taskade.com/apis-and-developer/developer-home.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.