actionstep-mcp

MCP server for Actionstep — 144 tools covering the full Actionstep REST API for law firm practice management. Use Actionstep from Claude Desktop with natural language.

What you can do

• Actions (Matters) — create, update, assign, track workflow steps, manage billing settings
• Participants (Contacts) — full CRUD, relationships, contact notes, phone records
• Tasks — create, assign, complete, filter by matter or assignee
• Time Records & Time Entries — log time, manage billable entries, activity codes
• Disbursements — log expenses, link to matters
• Calendar — appointments linked to matters
• Emails & SMS — log communications, associate with matters
• File Notes — attendance notes and case notes on matters
• Documents — action documents and folders
• Data Collections — custom form data on matters
• Webhooks — REST hook subscriptions for real-time events
• Reference data — action types, participant types, rates, UTBMS codes, tax codes

Requirements

• Python 3.10+
• Claude Desktop (or any MCP-compatible client)
• Actionstep developer credentials (Client ID, Client Secret)

Actionstep developer access: Register at the Actionstep developer portal to obtain OAuth credentials.

Installation

pip install actionstep-mcp

Setup

actionstep-mcp-setup

This opens a browser for OAuth authorization and saves credentials to ~/.actionstep-mcp/.

Verify:

actionstep-mcp-verify

Claude Desktop Configuration

{
  "mcpServers": {
    "actionstep": {
      "command": "actionstep-mcp"
    }
  }
}

Credential storage

By default credentials are stored in your operating system's native secret store via the cross-platform keyring library:

Secrets are saved under the service name actionstep-mcp. Nothing is written to disk in clear text.

File fallback. On a host with no keyring backend (e.g. a headless Linux box without Secret Service), or if you set ACTIONSTEP_MCP_USE_KEYRING=0, credentials fall back to a ~/.actionstep-mcp/.env file with 0600 permissions.

Read order. Credentials resolve in the order OS keyring → process environment → .env file. So a rotated secret in the keyring always wins, and an ACTIONSTEP_CLIENT_ID / ACTIONSTEP_CLIENT_SECRET exported in your shell overrides the file fallback without touching the keyring.

Authentication Notes

Actionstep uses a dynamic api_endpoint — the URL for your organisation's API is returned in the OAuth token response and varies per firm. The setup wizard captures and stores this automatically.

Example usage in Claude

"List my open actions"

>

"Create a task on action 456 — send retainer agreement to client"

>

"Log 2.5 hours on action 789, description: drafted statement of claim"

>

"Add a file note on action 123 — client called re: mediation date"

>

"Create a calendar appointment for the Jones hearing on Monday 10am"

License

MIT

<!-- ci-trigger 2026-05-27 -->