Connector

Axis connector documentation

Catalog 1.6.0 · MCP protocol 2025-06-18 · Generated from the public tool catalog

What Axis is

Axis is a personal life-management app. You keep your tasks, projects, notes, calendar, habits, goals, journal, health and fitness logs, and personal finances in one account at axisproductivityapp.com.

The Axis connector is a remote Model Context Protocol (MCP) server. It lets an AI assistant such as Claude, ChatGPT or Grok Bot read and update your own Axis account, but only in the areas you approve when you connect. Anything the assistant creates or changes shows up in Axis right away, just as if you had done it yourself in the app.

Before you start: you need an Axis account. You can sign up at axisproductivityapp.com with email, Google, or Apple. The connector only ever acts on the account you sign in with.

What the connector cannot do, by design:

• It cannot open your password vault. The vault is encrypted on your device, and no connector scope covers it.
• It cannot see, message or nudge habit partners, and it cannot reach any other person’s account.
• It cannot move money, make payments or transfers, or touch your bank login. Bank connections stay with Plaid, and finance tools only read and edit the records saved in Axis.
• It cannot rename or delete your life domains (list_domains is read-only), and it does not run Axis’s internal payroll, accounting or scheduled jobs.
• It cannot create repeating calendar events. Make the event once, then set up the repeat in the app.
• It cannot edit Google Calendar events. Those come back marked read-only, with a link to open them in Google.

How to connect

Claude

• From the directory (once Axis is listed): open Settings → Connectors, find Axis, and choose Connect.
• As a custom connector (works today): open Settings → Connectors → Add custom connector, name it Axis, and enter https://axisproductivityapp.com/mcp as the URL. Then choose Connect.

Claude opens Axis in your browser. Sign in, pick your scopes on the consent screen, and approve. Claude asks before it runs any tool marked destructive.

ChatGPT

• From the directory (once Axis is listed): open the plugin/app directory, search for Axis, and choose Connect.
• Before listing: with developer mode enabled, add a custom MCP connector that uses the URL https://axisproductivityapp.com/mcp and OAuth authentication.

ChatGPT registers itself with Axis automatically, so you don’t need a client ID or secret. Then it sends you to the Axis sign-in and consent screen. Each connector id has its own callback address; registration stores that exact address.

Grok Bot

Install the Axis plugin from the Grok Bot marketplace and connect the axis server. Grok Bot opens Axis so you can sign in and choose your scopes.

Any other MCP client

Point the client at https://axisproductivityapp.com/mcp using streamable HTTP. Any client that supports MCP authorization (protected-resource metadata, dynamic client registration, PKCE) can connect without extra setup. Here is a typical config:

{
  "mcpServers": {
    "axis": { "type": "http", "url": "https://axisproductivityapp.com/mcp" }
  }
}

How sign-in works (OAuth)

1. Discovery. A call without a token returns 401 with a WWW-Authenticate challenge. The challenge points to the protected-resource metadata at https://axisproductivityapp.com/.well-known/oauth-protected-resource/mcp, which names https://axisproductivityapp.com as the authorization server. Its metadata lives at /.well-known/oauth-authorization-server.
2. Client registration. The assistant registers itself at POST /oauth/register (RFC 7591 dynamic client registration). It registers as a public client (token_endpoint_auth_method: none), so no client secret is ever issued or stored in a package.
3. Authorization. The assistant opens /oauth/authorize with PKCE (S256 is the only method accepted). You sign in to Axis, review the scopes it asked for, untick any you don’t want, and approve.
4. Tokens. The assistant trades the code at /oauth/token. It gets an access token (prefix axis_ct_) and a refresh token (prefix axis_rt_). Supported grants: authorization_code and refresh_token.
5. Calls. Every MCP request carries Authorization: Bearer axis_ct_…. These tokens work only at /mcp. They aren’t a login to the Axis app or the rest of the Axis API.
6. Revoking access. Open Settings → Agent access in Axis and revoke the connection. Both the access and refresh tokens stop working immediately. You can also delete your whole account from Settings → Account.

Data access and scopes

Read and write are separate for every area. If a tool needs a scope you didn’t grant, it returns an “insufficient scope” error rather than any data. To change what you granted, disconnect and reconnect, then choose again on the consent screen.

If the assistant doesn’t ask for specific scopes, the consent screen pre-selects tasks:read, tasks:write, projects:read and notes:read. Finance and health are never pre-selected.

Where your data goes. Tool results go only to the assistant you connected. Axis doesn’t use your data to train models and doesn’t sell it. What the assistant does with your conversation is covered by that product’s own terms. Axis keeps an audit log of every connector call, whether it was allowed, denied or failed. For full details, see the Privacy Policy, section 5a.

Tool overview

Every tool has a title and explicit readOnlyHint, destructiveHint and openWorldHint annotations. The tables below are generated from catalog 1.6.0.

• Read tools never change anything.
• Write tools add something new (create, log, append, comment).
• Write, destructive tools edit, overwrite, complete, cancel or delete. Claude and ChatGPT ask you to confirm these.
• Most Axis deletes are soft deletes: the item moves to Settings → Trash and can be restored. The exceptions are noted in the tables.
• register_webhook is the only open-world tool, because it sends data to a URL you supply.

Conventions for every tool:

• IDs. Results tag records as [task:id], [library:id], [routine:id] and so on. Use those IDs on the next call. Tasks also have a permanent short number (#123), which find_task_by_number resolves.
• Structured output. Every tool declares an outputSchema and returns structuredContent.
• Safe retries. Every write accepts an optional idempotency_key (64 characters or fewer). Repeating a call with the same key within 24 hours returns the original result instead of acting twice.
• Concurrency. Some edits, such as finance records, spend bonuses, card benefits and workspace blocks, need the updated_at or revision you last read. They’re refused if the record changed since then.
• Time zones. Tools that work with dates take an optional tz (an IANA name such as America/Chicago). Without it they use the time zone saved in Axis Settings, or America/New_York if none is saved.

Tasks

Projects, boards and milestones

Notes, Library databases and comments

Workspace pages

Calendar and classes

Reminders

Habits (routines)

Goals and check-ins

Journal

People and dates

Health and fitness

Finance

Each saved finance record has its own tool. These tools edit records stored in Axis. They do not move money.

Books, movies and content

Brainstorms (mind maps)

Areas, retainers and inventory

Account-wide search, sync and webhooks

Example prompts

• “What’s on my plate today? Include overdue tasks and today’s calendar.”
• “Add a task to renew my passport next Friday, high priority, in my Personal domain.”
• “Find my notes about the kitchen remodel and summarize the budget.”
• “Move ‘Order countertops’ to Done on the Kitchen Remodel board.”
• “Check off my ‘Read 20 pages’ habit for today and tell me my streak.”
• “How has my weight changed over the last 30 days?”
• “Log today’s workout: bench press 3×8 at 135 lb, pull-ups 3×10.”
• “Draft a journal entry for today from what I got done.” (appends; it won’t overwrite unless you ask)
• “Who haven’t I followed up with in a while?”
• “Am I on track to hit the spend bonus on my travel card?” (needs finance:read)
• “Make a Library page comparing the three gyms I’m considering, with a table.”

Limits

Troubleshooting

Still stuck? Email the address on the Support page. Tell us which assistant you used, what you asked, and roughly when (with your time zone).

Links

• Privacy Policy (connector details in section 5a)
• Terms of Service
• Support
• Live tool catalog (JSON)
• Open-source plugin manifest