MCP server

Documentation index for AI agents: https://angelwood.io/docs/llms.txt

The Angelwood MCP server lets an AI assistant look things up in your Angelwood account: your clients, projects, open tasks and invoices. It is read-only. An assistant cannot create, change or send anything through it.

• Server URL (Streamable HTTP): https://mcp.angelwood.io/mcp
• Sign-in: OAuth with your own Angelwood account. API keys are not accepted.
• Configuration, skill and rules: github.com/NewOdysseyConsulting/angelwood-mcp

Connect

• Claude or ChatGPT: add the server URL as a custom connector.
• Cursor and other MCP clients: add this entry to your MCP settings.

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

The first time you use it, your client opens the Angelwood sign-in. After you approve, the assistant can read the same data you can see in Angelwood.

What you can ask

• Which invoices are overdue, and how much is outstanding in total?
• What is still open for one client this week?
• Give me an overview of a client: contact details, active projects and what they owe.
• Which active projects have the most open tasks?
• What is assigned to me and due by Friday?

Tools

Tool	What it returns
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 unless a status is given
angelwood_list_invoices	Invoices with amount, amount paid and balance due. Can return overdue invoices only

Organizations

Every tool call runs inside one organization you are an active member of. If you belong to more than one, the assistant is told which organizations you have and passes organization_id to choose one.

Limits

• Read-only: no creating, editing, sending or deleting.
• List tools return at most 50 results per call and can be paged.
• Time entries, estimates, proposals, client requests and client updates are not available through the MCP server.