How to Connect MOCO to Meta Muse via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → MOCO, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

MOCO + Meta Muse

Let your AI work with your MOCO agency account: look up projects and customers, review tracked time by person or project, check open invoices and team utilization, and book time. With your MOCO subdomain and an API key from your MOCO profile.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

MOCO_SUBDOMAIN, MOCO_API_KEY

Step 1 — Get credentials

1. In MOCO, click your profile picture at the top right to open your profile, then the Integrations tab, and copy your personal API key. It reaches exactly what your own MOCO user can see and do.
2. Alternatively, create an account API key under Settings → Extensions → API & Webhooks → API Keys, with read-only or full access. A read-only key cannot book time.
3. Paste the key into MOCO_API_KEY.
4. Set MOCO_SUBDOMAIN to the first part of your MOCO address only: for agency.mocoapp.com enter agency, without https:// and without .mocoapp.com. The connector then calls https://agency.mocoapp.com/api/v1.
5. Install the connector. There is no Authorize with Provider step: the key is stored encrypted and sent with every request.
6. Start with moco_list_users: if it lists your colleagues with their IDs, key and subdomain are right.

Staying signed in: the connector uses the key directly, so there is no sign-in to renew. If the key is replaced or deleted in MOCO, paste the new one into MOCO_API_KEY.

What the AI sees: every list returns only the records the key's user may see. A project or invoice that seems to be missing is usually a permission question in MOCO, not a fault of the connector.

Booking time: moco_create_activity is the only tool that writes to MOCO. It books one time entry for the user the key belongs to, with a date, a project ID, a task ID, the duration in whole seconds (2 hours is 7200) and an optional description. The AI finds the project with moco_list_projects and its tasks with moco_get_project. Every call creates a new entry, and a repeated call books the time twice, so the AI shows you date, project, task and duration first and waits for your yes.

Permissions and read-only setup: for a connector that only reads, disable moco_create_activity on the connector page, or use an account API key with read-only access. Do not hand a full-access key to people who should only read data.

Reports and invoices: moco_list_activities and moco_report_utilization always need a start and an end date (from and to, as YYYY-MM-DD). Activities can be narrowed to one person, one project or billable time only; the utilization report compares available and booked capacity. moco_list_invoices filters by status (draft, created, sent, partially_paid, paid, overdue, ignored, several at once separated by commas), invoice date and company.

Limits: lists return up to 100 entries per page, and the AI keeps paging until the last one. MOCO allows about 120 requests per two minutes on standard plans; above that it answers 429, so wait a moment and try again.

Common errors: 401 means the key is wrong, was deleted, or belongs to a different MOCO account than MOCO_SUBDOMAIN. If every call fails, check that MOCO_SUBDOMAIN holds only the subdomain and not the full address. 404 on a single project means the ID is wrong or the key's user cannot see that project. A rejected booking names the field MOCO did not accept, for example a task that does not belong to the project.

The connector does not create or send invoices, download PDFs, set up webhooks, edit or delete time entries, or change projects, companies and users.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Muse

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

1. In Muse, open Settings → Connectors and choose Add custom connector.
2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
4. In a chat, ask Muse for something that needs the MOCO tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Available tools

Example prompts

• "How many hours did the team book on the Website Relaunch project in September, and how much of that was billable?"
• "Which invoices are overdue or partially paid right now, and which customers do they belong to?"
• "How was the team's utilization last month? Compare available and booked capacity."
• "Book 2.5 hours today on the Acme website project for the homepage layout review. Show me the entry before you book it."

FAQ

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT
• Connect to Cursor
• Connect to Gemini