Maestro MCP setup
Connect your AI to your tasks
Maestro speaks the Model Context Protocol. Claude Code, Codex, Cursor, and Claude Desktop can read and write your tasks, projects, milestones, and roadmaps directly. Two ways to connect.
Local CLI agents. Generate an API key, paste one block into your config file. Works in seconds.
GUI clients with a Connect button. Sign in with your existing Maestro passkey or Google. No keys to paste.
API key flow
- Open Settings → Integrations.
- Click Generate API key. Pick a name, scopes (defaults to all), and expiry.
- Copy the key now— Maestro stores only a hash; you won't see it again.
- Paste the snippet below into your client's MCP config and restart it.
Claude Code
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"maestro": {
"url": "https://mcp-maestro.tedigo.com/mcp",
"headers": {
"Authorization": "Bearer mk_live_…"
}
}
}
}Codex CLI
Set MAESTRO_API_KEY + point at the hosted endpoint:
# ~/.config/codex/mcp.toml (or your client's equivalent)
[mcp_servers.maestro]
url = "https://mcp-maestro.tedigo.com/mcp"
headers = { Authorization = "Bearer mk_live_…" }Lost a key, or worried it leaked? Revoke it from Settings → Integrations — any client using it loses access immediately.
OAuth flow (no keys to paste)
- In your MCP client, add a new server with this URL:
https://mcp-maestro.tedigo.com - Your client opens a browser tab to Maestro's consent screen.
- Sign in with your usual passkey, Google, or password.
- Pick which scopes the client can access (read tasks, write tasks, etc.). Click Allow.
- You're redirected back to the client. Tools work immediately.
Tokens expire every 15 minutes and refresh silently for 30 days. After that you'll see the consent screen again.
Want to disconnect a client? Revoke its tokens from Settings → Integrations.
What your AI can do
The current tool surface mirrors the Maestro web app. A scoped key can be limited to read-only or any subset.
Tasks
list, get, create, update, mark done, attach progress notes
Projects
list, get, create, update, change owner, attach repos
Roadmaps
list, get, create roadmaps and milestones, attach projects
Executions
queue an AI execution, fetch its status and output
Need help?
Email hello@tedigo.com with the client name and any error message. Include the request id from the response if you have one.