duun

Agent setup

Connect an agent to duun

Use this page to give an AI client access to duun through MCP. You create the token, choose the scopes, and can revoke access later.

Open MCP settings

How setup works

OAuth is only for managed integrations. General AI clients should use MCP with a scoped token.

  1. 1

    Create a token

    Open MCP access in Settings, create a token, and choose only the scopes the client needs.

  2. 2

    Configure MCP

    Use https://duun.app/mcp as the server URL and the token as a Bearer token.

  3. 3

    Verify access

    Ask the client to list available duun tools. Rotate or revoke the token when access should change.

Public agent files

/llms.txt discovery /skills.md setup details

These files give agents the current setup instructions, tool semantics, and duun's task model.

Copy into your agent

Use the setup prompt once. Add the custom instructions when you want the agent to discover and follow duun's current guide.

Agent setup prompt 
Set up duun for this agent.

1. If public web access is available, read https://duun.app/llms.txt and https://duun.app/skills.md. If access is blocked by safeguards, continue with the available duun MCP tool descriptions and these instructions.
2. Configure duun as an MCP server at https://duun.app/mcp.
3. Ask me to create a scoped MCP token in duun Settings > Integrations.
4. Use that token as the Bearer token for the MCP server.
5. Do not use OAuth unless duun's setup page explicitly says this client is a managed OAuth integration.
6. Preserve duun's model: tasks are standalone primitive tasks; do not invent projects, lists, labels, folders, tags, areas, or collections.
7. Verify setup by listing available duun MCP tools.
Custom instructions 
Before working with duun, use https://duun.app/llms.txt and the linked https://duun.app/skills.md guide if public web access is available. If browsing or external URL access is blocked by safeguards, continue using the available duun MCP tool descriptions and these instructions.