MCP Server
Errand includes a built-in MCP (Model Context Protocol) server that gives AI agents access to tools while they work on your tasks. Think of it as a toolkit that agents can reach into whenever they need to do something — like searching the web, sending an email, or creating a new task.
What is MCP?
Section titled “What is MCP?”MCP is an open standard for connecting AI models to external tools and data sources. It provides a consistent way for agents to discover and use tools, no matter where those tools come from. You don’t need to understand the technical details — just know that it is what allows your agents to do useful things beyond generating text.
The Built-in Server
Section titled “The Built-in Server”Errand’s MCP server runs automatically as part of your installation at the /mcp/ endpoint. There’s nothing extra to install or configure —
it is ready to go out of the box.
Authentication
Section titled “Authentication”The MCP server is secured with a Bearer token to prevent unauthorised access. This token is auto-generated the first time Errand starts up.
To view your token:
- Go to Settings > Security
- Look for the MCP API Key field
Keep this key safe — anyone with this token can access your agent tools.
Built-in Tools
Section titled “Built-in Tools”The following tools are available to agents by default:
| Tool | Description |
|---|---|
new_task | Create a new task from within a running task |
task_status | Check the status and output of another task |
list_tasks | List tasks, optionally filtered by status |
web_search | Search the web via SearXNG |
list_emails | List emails from connected email account |
read_email | Read the full content of an email |
send_email | Send an email (restricted to authorised recipients) |
move_email | Move an email between folders |
forward_email | Forward an email |
list_email_folders | List available email folders |
Agents automatically choose the right tool for the job based on what your task requires. For example, if you ask Errand to “check my inbox and summarise new emails,” the agent will use list_emails and read_email behind the scenes.
Adding More MCP Servers
Section titled “Adding More MCP Servers”You can extend what your agents can do by registering additional MCP servers. This lets you connect custom tools or third-party services.
To add a new MCP server:
- Go to Settings > Agent Configuration
- Scroll to the MCP Server Configuration section
- Add your server details
Once registered, the tools from that server become available to your agents alongside the built-in ones.
Controlling Tool Access with Task Profiles
Section titled “Controlling Tool Access with Task Profiles”Not every task needs access to every tool. Task profiles let you control which MCP servers (and therefore which tools) are available for different types of tasks. For example, you might want a “research” profile that only has web search, or an “email” profile that includes email tools but not task management.
Using Errand’s MCP Server from Other Clients
Section titled “Using Errand’s MCP Server from Other Clients”The MCP server isn’t just for Errand’s own agents. You can point any MCP-compatible client at your Errand installation to use these tools externally. This means other AI applications or agents on your network can tap into Errand’s capabilities — like sending emails or managing tasks — through the same standard protocol.
To connect an external client, you’ll need:
- Your Errand server’s address (e.g.,
http://your-server:port/mcp/) - Your MCP API Key (found in Settings > Security)