Skip to main content
Glama

Angelwood MCP server

Angelwood is a client portal and client operations platform for agencies, consultancies and other service businesses. It gives each client a branded portal for updates, requests and files, and runs the back office behind it: projects and tasks, time tracking, estimates, proposals and invoices.

This repo holds the configuration, skill and rules for using Angelwood from AI assistants and editors (Claude, ChatGPT, Cursor, Hermes Agent and any MCP client). The server itself is hosted by Angelwood.

Server (Streamable HTTP): https://mcp.angelwood.io/mcp

Features

  • Hosted and remote. Nothing to install or run: one URL over Streamable HTTP.

  • Sign in with your Angelwood account. OAuth sign-in; no API keys in config files.

  • Read-only. Six tools that look things up. Nothing can be created, changed or sent.

  • Scoped to your organization. Every call runs inside one organization you are an active member of.

  • Works across clients. Claude, ChatGPT, Cursor, Hermes Agent and any MCP client.

  • Listed in the official MCP Registry as io.angelwood/angelwood.

Related MCP server: manager-mcp

Use cases

  • Chasing payment. Ask which invoices are overdue and what each client owes before a billing call.

  • Preparing for a client meeting. Get one client's contact details, active projects and outstanding balance in a single answer.

  • Weekly planning. List what is open, blocked or due this week across every project.

  • Spotting overloaded projects. See which active projects have the most open tasks.

  • Answering "where are we?" Look up a project's status and open work without opening the app.

Connect

  • Claude / ChatGPT: add https://mcp.angelwood.io/mcp as a custom connector.

  • Hermes Agent: the hermes/ package; see hermes/README.md to install and sign in.

  • Cursor: add .cursor/mcp.json from this repo (or copy the entry below) to your project or global MCP settings.

  • Any MCP client: use the entry in mcp.json.

{
  "mcpServers": {
    "angelwood": { "type": "http", "url": "https://mcp.angelwood.io/mcp" }
  }
}

On first use your client opens the Angelwood sign-in. Sign in and approve, and the assistant can then read the same data you can see in Angelwood. You need an Angelwood account: start a 14-day free trial.

What you can ask

  • "Which invoices are overdue, and how much is outstanding in total?"

  • "What's still open for Northwind this week?"

  • "Give me an overview of Acme: contact details, active projects and what they owe."

  • "Which active projects have the most open tasks?"

  • "List every task that is blocked, soonest due date first."

Tools

All tools are read-only. An assistant can look things up in Angelwood; it cannot create, change or send anything.

Tool

What it does

angelwood_whoami

The signed-in user and the organizations they belong to, with their role in each.

angelwood_search_clients

Active clients, optionally filtered by name or email.

angelwood_get_client_overview

One client's contact details, recent projects and invoice summary, including the balance still owed.

angelwood_list_projects

Projects with client, status, dates, hour budget and open task count.

angelwood_list_tasks

Tasks across projects, soonest due first. Open tasks by default.

angelwood_list_invoices

Invoices with amount, amount paid and balance due. Filter by status, client or project, or overdue only.

Every call runs inside one organization you are an active member of. If you belong to several, the assistant asks which one, or you can name it. Details are in skills/angelwood/SKILL.md.

Install the skill

npx skills add NewOdysseyConsulting/angelwood-mcp

Angelwood is made by New Odyssey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables read-only access to InvoiceNinja data, including invoices, expenses, clients, and tax reports, for AI assistants like Claude.
      1
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to query and manage self-hosted accounting data—invoices, balances, and books—through natural language, with read-only tools by default and optional scoped write operations.
      30
      24 PyPI
      1
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to safely inspect Stripe billing data such as subscriptions, invoices, failed payments, and churn, with read-only access, per-tool permissions, and a tamper-evident audit log.
      5 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to read field-service business data through a read-only MCP integration, including jobs, invoices, quotes, schedules, clients, and draft client messages. It handles authentication, token refresh, throttling, schema versioning, and account-currency formatting for live Jobber accounts.
      7
      MIT