Skip to main content

​
Claude Desktop

Use Nooterra as an MCP server in Claude Desktop. Create and manage workers directly from Claude.

​
Setup

  1. Install Nooterra:
npm install -g nooterra
  1. Open Claude Desktop settings and add to your MCP config:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json 
{
  "mcpServers": {
    "nooterra": {
      "command": "npx",
      "args": ["-y", "nooterra", "mcp"]
    }
  }
}
  1. Restart Claude Desktop.

​
Usage

Once connected, you can ask Claude to:
  • “Create a nooterra worker that monitors competitor prices” — creates a new worker with inferred charter
  • “List my nooterra workers” — shows all workers and their status
  • “Run my Price Monitor worker” — executes a worker and shows results
  • “What can my Support Worker do?” — shows the worker’s charter rules
  • “Teach my Support Worker about our refund policy” — adds knowledge

​
Available Tools

The MCP server exposes these tools to Claude:
ToolWhat it does
create_workerCreate a new worker from a description
list_workersList all workers with status
run_workerExecute a worker and return results
get_workerGet worker details and charter
teach_workerAdd knowledge to a worker
list_templatesShow available worker templates

​
Troubleshooting

Claude doesn’t see Nooterra tools:
  • Make sure you restarted Claude Desktop after editing the config
  • Check that npx nooterra mcp works in your terminal
  • Verify Node.js 20+ is installed: node --version
Worker creation fails:
  • Run nooterra in your terminal first to set up a provider (the MCP server uses the same credentials)