# Build on Taskade

You want to integrate Taskade into your app, automate your workflows, or connect your AI tools. This page gets you started fast.

## Integration Surface at a Glance

{% @mermaid/diagram content="graph TB
subgraph "Your Application"
APP\[Your App / Script / Agent]
end

```
subgraph "Integration Surface"
    SDK["@taskade/sdk<br/>TypeScript, npm"]
    API[Public API v2<br/>REST + OAuth 2.0]
    MCP_IN["@taskade/mcp<br/>Inbound MCP Server"]
    MCP_OUT[Hosted MCP v2<br/>Outbound Connectors]
    WEBHOOK[Webhooks<br/>Event delivery]
end

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

APP --> SDK
APP --> API
APP --> MCP_IN
WEBHOOK --> APP

SDK --> API
MCP_IN --> API
MCP_OUT --> AGENTS

API --> PROJECTS
API --> AGENTS
API --> AUTOMATIONS
API --> MEDIA

AGENTS -.writes LTM.-> PROJECTS" %}
```

## I Want To...

| I want to...                                                        | Use                                                                                                                                                                                                 |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ship a production integration in Node or TypeScript                 | [TypeScript SDK](https://docs.taskade.com/docs/apis-and-developer/developer-home/sdk-quickstart) + [SDK Cookbook](https://docs.taskade.com/docs/apis-and-developer/developer-home/sdk-cookbook)     |
| Hit endpoints from any language                                     | [Public API v2 Reference](https://docs.taskade.com/docs/apis-and-developer/developer-home/api-v2-reference)                                                                                         |
| Expose Taskade data to Claude Desktop, Cursor, or other MCP clients | [Workspace MCP](https://docs.taskade.com/docs/apis-and-developer/developer-home/workspace-mcp) + [Advanced](https://docs.taskade.com/docs/apis-and-developer/developer-home/workspace-mcp-advanced) |
| Give a Taskade agent third-party capabilities                       | [Hosted MCP v2 Connectors](https://docs.taskade.com/docs/apis-and-developer/workspace-mcp-advanced#mcp-connectors)                                                                                  |
| Edit Genesis app source code from your IDE                          | [Genesis App MCP (Beta)](https://docs.taskade.com/docs/apis-and-developer/developer-home/genesis-app-mcp)                                                                                           |
| Receive real-time events in your app                                | [Webhooks](https://docs.taskade.com/docs/apis-and-developer/developer-home/webhooks)                                                                                                                |
| Build an app with end-user sign-in                                  | [GenesisAuth](https://docs.taskade.com/docs/community-and-sharing/community-and-sharing/genesis-auth) in Genesis                                                                                    |
| Understand long-term memory                                         | [Long-Term Memory](https://docs.taskade.com/docs/apis-and-developer/developer-home/long-term-memory)                                                                                                |
| Build agents that run without prompting                             | [Autonomous Agents](https://docs.taskade.com/docs/apis-and-developer/developer-home/autonomous-agents)                                                                                              |
| Automate workflows without code                                     | [Automations Engine](https://docs.taskade.com/docs/automations/automation)                                                                                                                          |
| 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                                                                     |
| ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
| [Public API v2 Reference](https://docs.taskade.com/docs/apis-and-developer/developer-home/api-v2-reference)        | Top-10 most-used endpoints with cURL, TypeScript, and Python examples           |
| [TypeScript SDK Quickstart](https://docs.taskade.com/docs/apis-and-developer/developer-home/sdk-quickstart)        | Install `@taskade/sdk` and ship your first call in 5 minutes                    |
| [SDK Cookbook](https://docs.taskade.com/docs/apis-and-developer/developer-home/sdk-cookbook)                       | Patterns for agents, automations, webhooks, error handling, pagination, testing |
| [Workspace MCP](https://docs.taskade.com/docs/apis-and-developer/developer-home/workspace-mcp)                     | Connect Claude Desktop, Cursor, and other AI tools to your workspace            |
| [Workspace MCP — Advanced](https://docs.taskade.com/docs/apis-and-developer/developer-home/workspace-mcp-advanced) | Rate limits, multi-client setup, troubleshooting, security                      |
| [Genesis App MCP (Beta)](https://docs.taskade.com/docs/apis-and-developer/developer-home/genesis-app-mcp)          | Edit your Genesis app's source code from your IDE via OAuth                     |
| [Webhooks](https://docs.taskade.com/docs/apis-and-developer/developer-home/webhooks)                               | Subscribe to workspace events and verify signatures                             |
| [Bundles & App Kits](https://docs.taskade.com/docs/apis-and-developer/developer-home/bundles)                      | Import/export full Genesis apps as portable bundles                             |
| [Long-Term Memory](https://docs.taskade.com/docs/apis-and-developer/developer-home/long-term-memory)               | Memory-as-Projects architecture — editable, queryable, API-addressable          |
| [Autonomous Agents](https://docs.taskade.com/docs/apis-and-developer/developer-home/autonomous-agents)             | Automations, orchestration, cross-agent invocation patterns                     |
| [Authentication Guide](https://docs.taskade.com/docs/apis-and-developer/developers/authentication)                 | Personal tokens and OAuth 2.0 flows                                             |
| [API Endpoint Guide](https://docs.taskade.com/docs/apis-and-developer/comprehensive-api-guide)                     | Detailed per-endpoint documentation with examples                               |

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

## Base URL

All REST API requests go to:

```
https://www.taskade.com/api/v1
```

Include your token in the `Authorization` header:

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

## 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 %}